指南 · 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 分钟出结果。