指南 · Raycast 擴充功能

Raycast 擴充功能怎麼被 AI 搜尋找到?

更新於 2026-11-11 · kagentx

簡答

把 package.json 的 description 寫成一句話定義,給每個 command 寫具體的 title 和 description,README 第一段回答「它是什麼、怎麼用」。2026-11-11 實測:raycast.com 的 robots.txt 沒有點名 AI 爬蟲,擴充功能詳情頁的標題、描述、指令名稱和 README 全文不執行腳本就能讀到,但沒有結構化資料,我們讀到的 sitemap 裡也沒有擴充功能詳情頁。這些頁面是否被 AI 引用,我們沒有證據,未核實。

Raycast Store 對 AI 爬蟲放行嗎?頁面是伺服器端直出的嗎?

放行,而且正文直出。2026-11-11 實測:raycast.com 的 robots.txt 只禁四條帳號和升級相關的路徑,沒有點名任何 AI 爬蟲,GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、PerplexityBot、Google-Extended、Bingbot 都走 * 群組,是放行的。擴充功能詳情頁(我們取了 thomas/color-picker)不執行腳本就能讀到標題、描述、作者、安裝次數、指令名稱和 README 全文。

檢查項目實測結果(2026-11-11)
robots.txt* 群組 Allow: /,只禁 /upgrade、/settings/sessions、/handles/new、/users/confirmation;沒有點名 AI 爬蟲
詳情頁 HTTP 狀態和大小200;Color Picker 約 185 KB,GitHub 擴充功能約 346 KB
<title>「Raycast Store: 擴充功能名稱」,來自 package.json 的 title
meta description和 package.json 的 description 完全一致(Color Picker:Pick and organize colors, everywhere on your Mac)
正文是否直出是:作者、安裝次數、README 全文、指令名稱都在 HTML 裡;沒有結構化資料(JSON-LD)
sitemap.xml98 個網址,只有首頁、商店首頁、功能頁、部落格等;我們查的兩個擴充功能詳情頁都不在裡面,其他 sitemap 未核實

結論:在 Raycast 上,爬蟲能讀到的內容就是你寫在 package.json 和 README 裡的內容。擴充功能詳情頁不在我們讀到的 sitemap 裡,爬蟲要靠商店列表頁和站內連結找到它,所以別處(你的 GitHub README、官網)連到商店頁也有用。爬蟲是否執行腳本見 AI 爬蟲會執行 JavaScript 嗎?。

package.json 的欄位怎麼變成商店頁?

擴充功能的 package.json 是公開的,放在 github.com/raycast/extensions 倉庫裡(我們讀了 color-picker 的 package.json,對照它的商店頁)。欄位說明來自 Raycast 開發者文件(developers.raycast.com,2026-11-11 查看)。

package.json 欄位官方說明商店頁上看到的(Color Picker)
title商店和偏好設定裡顯示的標題,用它把擴充功能描述好,使用者才搜得到頁面 <title> 和標題:Color Picker
description顯示在商店裡的完整描述meta description 和標題下的一句話,原樣一致
commands[].title、description每個指令的名稱和說明頁面裡直出指令名稱,如 Pick Color;列表裡顯示指令數(9 Commands)
README.md擴充功能目錄裡的說明檔Overview 標籤裡的正文:功能、API、選項,直出在 HTML 裡
author你的商店使用者名稱頁面網址 /thomas/color-picker 裡的 thomas
platforms支援的系統:macOS 或 Windows列表裡有「macOS only」標記
keywords使用者在商店裡搜這些詞能找到擴充功能站內搜尋用;我們沒有核實它是否出現在頁面原始碼裡
categories擴充功能所屬分類分類在頁面上怎麼顯示,未核實
{
  "$schema": "https://www.raycast.com/schemas/extension.json",
  "name": "example-ext",
  "title": "Example Ext",
  "description": "One sentence: what it does and for whom",
  "icon": "icon.png",
  "author": "your-handle",
  "platforms": ["macOS"],
  "categories": ["Productivity"],
  "license": "MIT",
  "commands": [
    {
      "name": "search-notes",
      "title": "Search Notes",
      "description": "Search your notes by title and content",
      "mode": "view"
    }
  ]
}

上面是寫法範例(名稱是占位)。注意 description 同時是 meta description 和頁面副標題:一句話寫清「做什麼、給誰」,不要寫成口號。更新說明在 Version History 標籤裡,它的內容我們沒有核實。

Raycast、Alfred 和 Chrome 線上應用程式商店的發現管道有什麼不同?

同一個「給效率工具寫擴充功能」的開發者,在三個管道上的頁面對 AI 爬蟲的表現不同。2026-11-11 各取了一個頁面實測。

管道robots.txt頁面 title 和 meta description結構化資料正文是否直出
Raycast Store(raycast.com)只禁帳號和升級路徑title「Raycast Store: 名稱」;description 是你的 description沒有是,README 全文
Alfred Gallery(alfred.app/workflows/)alfred.app 回傳 404,www.alfredapp.com 回傳空檔案,都沒有規則title「Alfred Gallery • Workflows • 名稱」;description 是「名稱: 一句話」沒有是,版本、作者、用法
Chrome 線上應用程式商店(chromewebstore.google.com)禁評價、隱私、支援等子頁和帶追蹤參數的網址title「名稱 - Chrome Web Store」;description 是一句話簡介沒有是,含評分和評價數

三個管道的詳情頁都不靠腳本才有正文,也都沒有結構化資料,所以差別不在「能不能讀到」,而在「讀到的是誰寫的話」:Raycast 和 Alfred 讀到的是你寫的描述和 README,Chrome 線上應用程式商店讀到的是你填的簡介。Chrome 擴充功能的完整寫法見 Chrome 擴充功能怎麼被 AI 推薦?;VS Code 擴充功能的對應寫法見 VS Code 擴充功能怎麼被 AI 推薦?。

怎麼一步一步讓 Raycast 擴充功能更容易被找到?

  1. 1. 把 description 寫成一句話定義

    「做什麼、給誰用、替代什麼」,它同時是商店頁的副標題和 meta description。

  2. 2. 每個指令的 title 和 description 寫具體

    指令名稱會直出在商店頁裡,使用者和爬蟲都靠它判斷擴充功能能做什麼;寫成動詞開頭:Search Notes,而不是 Main。

  3. 3. README 第一段回答「它是什麼、怎麼用」

    README 是商店頁的 Overview 正文;功能、選項、截圖說明都寫在這裡,寫法見 GitHub README 怎麼寫,AI 才會引用?。

  4. 4. 在自己的 GitHub README 和官網連到商店頁

    我們讀到的 sitemap 裡沒有擴充功能詳情頁,別處的連結能幫爬蟲找到它。官網加 SoftwareApplication 資料的寫法見 SaaS 要不要加 SoftwareApplication 結構化資料?。

  5. 5. 先確認官網沒有擋住搜尋爬蟲

    用 AI 爬蟲檢查 看 robots.txt。

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

    問 ChatGPT、Perplexity「Raycast 有什麼做某某的擴充功能」,每個問題問 3 次,記下有沒有提到你、引用了哪些網址。

JetBrains Marketplace 的外掛頁是腳本渲染的,實測和官方上架規定見 JetBrains 外掛怎麼被 AI 搜尋找到?Marketplace 外掛頁實測。

常見問題

Raycast Store 的頁面會被 ChatGPT 引用嗎?

我們沒有找到官方說明,也沒有拿到實際引用的證據,未核實。能確認的是:2026-11-11 實測 raycast.com 的 robots.txt 沒有限制 AI 爬蟲,擴充功能詳情頁的正文直接寫在 HTML 裡。

商店頁的 meta description 是哪裡來的?

2026-11-11 實測:Color Picker 的 meta description 和 package.json 裡的 description 完全一致,所以 description 要當成搜尋結果裡的摘要來寫。

README 對 Raycast 擴充功能重要嗎?

重要。商店頁的 Overview 標籤直出 README 的正文(我們取的 Color Picker 頁面裡能讀到 Key Features 和 API 說明),它是爬蟲能讀到的最長的一段你寫的文字。

為什麼我的擴充功能頁不在 sitemap 裡?

我們讀到的 raycast.com/sitemap.xml 有 98 個網址,沒有擴充功能詳情頁,其他 sitemap 未核實。這不是你的問題,但意味著別處的連結(README、官網、文章)對爬蟲發現你的頁面更有用。

Raycast 擴充功能要不要同時做 Windows 版?

package.json 的 platforms 可以寫 macOS 或 Windows,寫哪個取決於你的擴充功能用到的介面。商店列表裡有「macOS only」這樣的標記,寫準支援的系統,使用者和 AI 回答「能不能在 Windows 上用」時有明確依據。

Alfred workflow 和 Raycast 擴充功能能共用一份描述嗎?

可以。兩個管道的詳情頁都直出你寫的一句話描述和用法,用同一句話的不同長度,保持名稱和功能的說法一致。

要不要給擴充功能做自己的官網?

建議至少有一頁:寫清擴充功能做什麼、支援什麼系統、怎麼安裝、更新日誌,並連到商店頁。商店頁的格式由別人定,官網是你能寫全的地方。

出處

kagentx

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

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