指南 · Obsidian

Obsidian 外掛怎麼在 AI 搜尋裡被找到?

更新於 2026-11-11 · kagentx

簡答

你的外掛在公開網頁上只有三處:社群目錄的外掛頁(標題來自 name,meta description 來自 description,內文基本是 README)、GitHub 儲存庫首頁,以及只有五個欄位的 community-plugins.json。2026-11-11 實測:obsidian.md 的 robots.txt 全部放行,GitHub 對 AI 爬蟲禁的是 raw、目錄樹等子路徑,儲存庫首頁沒禁。所以要做的是把 description 和 README 第一屏寫清楚。

Obsidian 外掛的資訊出現在哪些公開頁面上?

三處:社群目錄裡你的外掛頁、GitHub 儲存庫首頁(也就是 README),以及 community-plugins.json 這份清單。2026-11-11 我們取了一個樣本外掛(Git):obsidian.md/plugins?id=obsidian-git 會 301 到 community.obsidian.md/plugins/obsidian-git,這個頁面的 HTML 裡直接有標題、描述、canonical、h1 和 README 內文,不需要執行腳本。

community-plugins.json 當天有 10,232 筆,每筆只有 id、name、author、description、repo 五個欄位,沒有 README、沒有標籤、沒有截圖。所以 AI 能從這份清單讀到的,只有你的名稱、作者和一句話描述。

這五個欄位分別從哪裡來、出現在哪裡?

欄位來源出現在哪裡(2026-11-11 實測)
idmanifest.json 的 id外掛頁網址 community.obsidian.md/plugins/<id>;必須唯一,不能含 obsidian
namemanifest.json 的 name外掛頁 <title>(“Git - Obsidian Plugin”)和 <h1>;應用程式內搜尋也用它
authormanifest.json 的 author外掛頁上的作者名;應用程式內搜尋用
descriptionmanifest.json 的 description外掛頁的 meta description,和 community-plugins.json 裡的那句完全一樣
repo你提交的 GitHub 儲存庫外掛頁讀取 README 的地方;也是 AI 能看到的另一個頁面(儲存庫首頁)

官方文件(Manifest 頁)把 name、author、description、id、isDesktopOnly、minAppVersion、version 都列為必填。name 要短、具描述性,不能含 “Obsidian”,外掛名稱不能含 “Plugin”。description 官方沒有寫字數上限,未核實。出自 obsidian-developer-docs,2026-11-11 讀 GitHub 上的原文。

README 在外掛頁上起什麼作用?

官方的提交文件寫明:README.md 要說明外掛的用途和用法,摘要會顯示在公開的列表頁,相對連結和圖片會改寫成指向你的儲存庫。我們取到的樣本頁,可見文字約 1 萬字元,裡面就有 README 的段落(功能列表、文件連結、行動裝置說明)。

也就是說,外掛頁的內文基本就是你的 README。README 的第一段寫不清楚,AI 在外掛頁和儲存庫首頁讀到的就是同樣含糊的東西。寫法見 GitHub README 會被 AI 搜尋引用嗎?,開源專案的整體做法見 開源專案怎麼被 AI 搜尋推薦?README 以外的 6 個地方。

# Git (title: what it does, in the plain words people search)

One sentence: what the plugin does and for whom.
Install: Settings > Community plugins > Browse > search the name.
Features: a bullet list, one real feature per line.
Settings and commands: the exact command names.
Mobile / desktop only: say it.
Changelog: link to GitHub releases.

obsidian.md 和 GitHub 的 robots.txt 對 AI 爬蟲怎麼設?

網站robots.txt 現況(2026-11-11)對 AI 爬蟲意味著什麼
obsidian.md200,23 位元組:User-agent * Allow: /沒有點名任何 AI 爬蟲,全部放行
community.obsidian.md沒有真正的 robots.txt:/robots.txt 回傳 200,但內容是 HTML 頁面;首頁帶 noindex,外掛樣本頁沒有 robots meta沒有 robots 規則可讀;首頁 noindex,外掛頁本身沒有 noindex
github.comGPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User 共用一組,Crawl-delay: 1,約 280 條 Disallow禁的是 /*/raw/、/*/tree/、/*/blame/、/*/archive/、提交列表、比較頁等;儲存庫首頁不在 Disallow 裡(按文字讀,未用真實爬蟲驗證)
github.com(Bytespider)Disallow: /整站禁止

所以 AI 爬蟲能讀到的是:社群目錄的外掛頁,以及 GitHub 儲存庫首頁和渲染後的 README。讀不到的是 raw 檔案和目錄樹,這意味著把關鍵說明只放在 docs/ 下的某個子檔案裡,不如放在 README 首頁。robots.txt 的寫法見 AI 爬蟲的 robots.txt 怎麼寫?。

提交之後,我應該做什麼?

  1. 1. 第一句描述寫成人會搜的話

    description 會同時出現在 meta description 和應用程式內搜尋裡。寫「這個外掛做什麼、給誰用」,不要只寫功能名。例:「Integrate Git version control with automatic backup」比「Git plugin」更容易被引用。

  2. 2. README 首屏先答「它是什麼、怎麼安裝、能做什麼」

    照上面的範本寫。安裝方式寫成 Settings > Community plugins > Browse,這是使用者會照著問的問題。

  3. 3. 在 GitHub 儲存庫的 About 裡再寫一句

    儲存庫 About 的文字會出現在儲存庫首頁的 title 和 description 裡。樣本裡它和目錄的 description 不一樣,兩處各寫一遍,等於給 AI 兩個讀到你的機會。

  4. 4. 用 curl 看一遍公開頁

    把 id 換成你的外掛,看標題、描述是不是你寫的那句,README 裡的一句話能不能 grep 到。內文要在 HTML 裡,原因見 AI 爬蟲會執行 JavaScript 嗎?。

    # What does the public plugin page say in raw HTML?
    curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -io '<title>[^<]*</title>'
    curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -io '<meta[^>]*name="description"[^>]*>'
    curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -c "a sentence from your README"
  5. 5. 在 ChatGPT、Perplexity 裡問三次

    問「Obsidian 裡怎麼做 X」,開聯網搜尋,記下推薦了哪些外掛、引用了哪些網址。ChatGPT 或 Perplexity 是否引用 community.obsidian.md 的外掛頁,我們沒有證據,未核實,要靠你自己測。

和別的外掛市集比,Obsidian 有什麼不同?

Obsidian 社群目錄GitHub 儲存庫
誰產生頁面目錄從 manifest 和 README 產生你自己
能改的文字name、description(改 manifest)、READMEAbout、README、Topics
AI 爬蟲能讀到標題、描述、README 內文(樣本頁)儲存庫首頁和 README;raw、目錄樹被禁
官方沒寫的description 字數上限、AI 是否引用—

做的是 Figma 外掛的話,Figma 社群外掛頁的 robots.txt、sitemap 和官方上架要求見 Figma 外掛怎麼被 AI 搜尋找到?社群外掛頁的 robots、sitemap 與官方要求。

同樣是外掛生態,做 Minecraft 模組或伺服器外掛的話,Modrinth 和 CurseForge 的頁面實測見 Minecraft 模組怎麼被 AI 搜尋找到?。

常見問題

Obsidian 外掛的頁面能被 ChatGPT、Perplexity 讀到嗎?

按 2026-11-11 的實測,外掛頁的 HTML 裡直接有標題、描述、canonical 和 README 內文,沒有 noindex。真實 AI 爬蟲是否讀取、是否引用,我們沒有證據,未核實。

community-plugins.json 裡有哪些欄位?

id、name、author、description、repo 五個,2026-11-11 共 10,232 筆。沒有 README 和截圖。

外掛的 description 有字數限制嗎?

官方 Manifest 頁沒有寫數字,未核實。建議寫成一句話,說清做什麼、給誰用。

GitHub 會不會禁止 AI 爬蟲讀我的 README?

github.com/robots.txt 對八個 AI 爬蟲的 Disallow 主要是 raw、目錄樹、提交、比較等子路徑,儲存庫首頁不在其中。這是按文字讀的,沒有用真實爬蟲驗證。

外掛名稱裡能放關鍵字嗎?

官方要求名稱短、具描述性,不能含 “Obsidian”,外掛名稱不能含 “Plugin”。關鍵字放進 description 和 README 裡。

要不要給外掛單獨做一個介紹網站?

不是必須。外掛頁和 README 已經是伺服器端直出的內文。如果要做,把它寫成一個說明頁,內容和 README 一致,並連回外掛頁。

community.obsidian.md 首頁為什麼是 noindex?

我們只看到首頁帶 noindex,外掛樣本頁沒有。官方沒有解釋原因,未核實。

出處

kagentx

AI 的回答裡
有沒有你?

評測會把買家的問題拿去問 ChatGPT、Perplexity、Claude(開啟連網搜尋),記下推薦了誰、引用了哪些網頁、你在不在裡面。基礎版 $1,一般 2–3 分鐘出結果。