指南 · 命令列工具

命令列工具怎麼被 AI 推薦?Homebrew、GitHub 和官網文件頁實測

更新於 2026-11-12 · kagentx

簡答

2026-11-12 實測:Homebrew 的 formula 頁和 GitHub 儲存庫頁都是伺服器端直出的,formula 頁還有公開的 JSON API;formulae.brew.sh 的 robots.txt 沒有任何禁止規則,GitHub 對 AI 爬蟲的規則是 Crawl-delay: 1,沒有整站禁止。但 formula 頁的 meta description 是通用文案,官網 title 往往只有工具名。所以把一句話描述寫成同一句,放在 formula 的 desc、GitHub About 和官網 description 三個地方,並把安裝指令和最小範例放進官網。AI 是否引用 formulae.brew.sh,我們沒有證據,未核實。

一個命令列工具有哪幾個頁面會被 AI 讀到?

通常是三個:Homebrew 的 formula 頁、GitHub 儲存庫頁、官網的文件頁。2026-11-12 我們拿 jq 當範例,用 curl 取了這三類頁面(不執行指令碼,User-Agent 是 Mozilla/5.0,沒有模擬 AI 爬蟲),三個都直接回傳正文:

頁面HTTP 和大小title 和 meta description可見正文(去掉腳本後)
formulae.brew.sh/formula/jq200,11,096 位元組title 是 “Homebrew Formulae: jq”;meta description 是通用的 “Homebrew’s package index”;有 canonical約 1,230 字元:安裝指令、一句話描述、官網、授權、版本、相依套件、下載數
github.com/jqlang/jq200,約 297 KBtitle 帶專案名和一句話;meta description 是一句話加 GitHub 的通用後半句;沒有 canonical 標籤約 5,670 字元,含 README 的 Installation 等小節
jqlang.org(官網)200,11,540 位元組title 只有 “jq”;沒有 meta description;canonical 指向 jqlang.org約 2,431 字元

三個頁面的 title 都不夠描述工具本身,只有 formula 頁和 GitHub 頁正文裡有「是什麼」的一句話。所以三個地方的一句話要寫成同一句,並且讓官網的 title 和 description 自己寫清楚;原理見 AI 爬蟲會執行 JavaScript 嗎?。

Homebrew 的 formula 頁和 JSON API 有哪些欄位?

formula 頁是伺服器端直出的,同一份資料還有公開的 JSON API:formulae.brew.sh/api/formula/jq.json 回傳 4,462 位元組,不需要登入;全量的 formula.json 是 32,279,544 位元組、8,730 筆。幾個對「被找到」有用的欄位(jq 的實測值):

欄位頁面上的位置jq 的值
desc正文第一句Lightweight and flexible command-line JSON processor
homepage正文裡的連結https://jqlang.github.io/jq/
license正文 License 一行MIT
versions.stableCurrent versions1.8.2
executablesBinariesjq
dependenciesDepends ononiguruma 6.9.10
analytics、github_packages_downloads下載數、安裝事件(近 30 天)頁面上寫 280,128 次下載、63,420 個安裝事件;資料來源和日期寫在頁面裡

formula 頁的 JSON-LD 只有一個通用的 WebPage,沒有 SoftwareApplication;sitemap 有 16,605 個網址(含 /formula/ 的 8,731 個、含 /cask/ 的 7,826 個),沒有 lastmod;robots.txt 只有一行 Sitemap,沒有任何禁止規則。以上都是 2026-11-12 實測,來源 formulae.brew.sh/formula/jq。

Homebrew 官方對 desc 和 homepage 有什麼要求?

Homebrew 的 Formula Cookbook(docs.brew.sh,2026-11-12 讀原文)寫得很短:

欄位官方要求
desc用一行概括 formula 做什麼;formula 名會在列印時自動加在 desc 前面,不用重複;原文沒有寫字元上限
homepage必填,官方寫明不接受沒有 homepage 的 formula;優先用 https;官網攔自動請求時,可以寫 browsed: 日期,跳過一年的自動檢查
class Mytool < Formula
  desc "Command-line tool that converts CSV files to JSON"
  homepage "https://mytool.example.com/"
  url "https://github.com/example/mytool/archive/refs/tags/v1.0.0.tar.gz"
  license "MIT"
end

上面是寫法範例。官方沒有寫 desc 怎麼影響搜尋或 AI 引用,這一點我們沒有證據,未核實。但 desc 同時出現在 formula 頁正文和公開 JSON 裡,是兩個地方都讀得到的那一句,值得認真寫。

GitHub 儲存庫頁和官網文件頁怎麼配合?

GitHub 的 robots.txt(29,821 位元組)把 GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User 放在同一個組:Crawl-delay: 1,沒有 Disallow: /,禁的是 /*/tree/、/*/raw/、/*/blame/、/*/archive/ 和帶 ?tab=、?q= 的網址。儲存庫首頁沒有被禁,子目錄頁被禁,所以 README 要在儲存庫首頁能讀完整。README 的寫法見 GitHub README 會被 AI 搜尋引用嗎?。

官網文件頁是你唯一能完全控制 title、description、canonical 和結構化資料的地方。jq 的官網 title 只有 “jq”,沒有 meta description,這是一個可以改進的地方:寫成「工具名 — 一句話描述」。文件的寫法見 開發者文件怎麼寫,AI 才讀得懂、引得到?。

怎麼一步一步讓命令列工具更容易被找到?

  1. 1. 寫一句話,三個地方用同一句

    formula 的 desc、GitHub 儲存庫的 About、官網的 meta description 和首屏第一句,寫成同一句:做什麼、給誰用、取代什麼。

  2. 2. 官網首頁和文件頁寫清 title 和 description

    title 用「工具名 — 一句話描述」,description 寫 120–160 字元的完整句子;jq 官網 title 只有工具名,是反面例子。

  3. 3. 官網放安裝指令和最小範例

    brew install、其他套件管理器、一個能複製的最小範例。formula 頁正文只有安裝指令,沒有範例,範例要寫在官網和 README。

  4. 4. README 開頭和官網對齊

    README 的前幾行寫工具做什麼和安裝指令,寫法見 GitHub README 會被 AI 搜尋引用嗎?;套件倉庫(npm、PyPI)的頁面見 npm、PyPI 上的套件怎麼被 AI 推薦?。

  5. 5. robots.txt 不要誤攔

    官網的 robots.txt 檢查有沒有按 User-Agent 攔 AI 爬蟲,寫法見 AI 爬蟲的 robots.txt 怎麼寫?。

  6. 6. 隔幾週用同一組問題再測

    問 ChatGPT、Perplexity「有沒有做某某的命令列工具」「某某怎麼用 brew 安裝」,每個問題問 3 次,記下有沒有提到你、引用了哪些網址。

同類的指南:開源專案怎麼被 AI 搜尋推薦?README 以外的 6 個地方;桌面端的對照見 Mac 應用程式怎麼被 AI 推薦?、Linux 應用程式怎麼被 AI 搜尋推薦?。

常見問題

formulae.brew.sh 的 formula 頁,爬蟲不執行指令碼也讀得到嗎?

讀得到。2026-11-12 我們用 curl 取 jq 的頁面(11,096 位元組,不執行指令碼),去掉指令碼後約 1,230 個可見字元,裡面有安裝指令、一句話描述、官網、授權、版本、相依套件和下載數。只測了這一頁。

formula 頁的 meta description 是我的描述嗎?

不是。jq 頁的 meta description 是 Homebrew 通用的 “Homebrew’s package index”。你的描述出現在頁面正文和 JSON API 的 desc 欄位裡,不在 meta description 裡。我們只測了 jq 一頁,其他頁是否相同未核實。

desc 應該寫多長?

Homebrew 的 Formula Cookbook 只要求用一行概括 formula 做什麼,沒有寫字元上限;formula 名會自動加在 desc 前面,所以不要重複名字。

一定要有官網嗎?

formula 必須有 homepage(官方原話是不接受沒有 homepage 的 formula)。官網是你能把用法、對比和安裝方式寫全的地方,見這篇指南的步驟。

GitHub 的 robots.txt 對 AI 爬蟲是什麼規則?

2026-11-12 實測:GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User 在同一個組,Crawl-delay: 1,沒有 Disallow: /;禁的是 /*/tree/、/*/raw/、/*/blame/ 等路徑和帶 ?tab= 的網址。儲存庫首頁沒有被禁。

AI 回答裡會引用 formulae.brew.sh 嗎?

我們沒有拿到引用證據,未核實。能確認的只是它對爬蟲開放、頁面直出安裝指令。

官網文件頁要寫哪些內容?

至少寫清:這個工具做什麼、怎麼裝(brew install 和其他方式)、一個最小範例、和相近工具的區別。寫法見開發者文件那篇指南。

要不要給命令列工具加 SoftwareApplication 結構化資料?

formula 頁本身的 JSON-LD 只有通用的 WebPage。你自己的官網可以加,寫法見 SoftwareApplication 那篇指南;加了是否被 AI 引用,我們沒有證據。

出處

kagentx

你的頁面,爬蟲讀得到嗎?
讓評測告訴你

評測檢查爬蟲能不能進、正文是否直出,再把買家的問題拿去問 ChatGPT、Perplexity、Claude(開連網搜尋),看有沒有提到你。基礎版 $1,一般 2–3 分鐘出結果。