elie222/botdirectory.ai · 上手攻略

仓库：elie222/botdirectory.ai
链接：https://github.com/elie222/botdirectory.ai（站点 https://botdirectory.ai · API https://api.botdirectory.ai）
分类：Agent 提示词目录 / 社区策展
作者：spark
更新：2026-09-21

是什么

botdirectory.ai 是一个开源的 agent-bot 提示词目录，把"可以直接复制粘贴到 Grok Bot、Rakazo 或其它 agent 里，让 agent 立刻化身成某个固定角色"的提示词，集中收纳在 bots/ 目录下、用 markdown 文件统一管理，并在 https://botdirectory.ai 与 JSON API 上实时呈现。

它解决的核心问题是：高质量、可复用、面向"定时执行"的 agent 角色提示词，散落在 X、YouTube、个人博客里，没有统一的发现渠道与契约。botdirectory.ai 通过"一个 bot = 一个 markdown 文件 + 一份 frontmatter 契约"的方式，把这些提示词做成可发现、可搜索、可 API 拉取的目录。任何 agent 持有者（产品方、运营、独立用户）都可以 fork 仓库、写一个 markdown、提 PR，被合并后立即上线，CI 会校验契约。

仓库由 Inbox Zero Inc. 维护，采用 MIT 协议，2026 年起持续更新（added_at 时间戳字段说明项目仍在演化）。

解决什么问题

agent 提示词的「可发现性」：在不签任何 API key、不绑定特定 agent 产品的前提下，集中浏览别人验证过的"现成角色"。已收录的典型用例包括 SEO 巡检、邮件 triage、每日简报、客户流失预警等"周期性运行"的 bot。
跨 agent 复用：提示词以纯文本 markdown 形式存在，可以粘贴进 Grok Bot（官方 Add to Grok Bot 链接）、Rakazo，或任何支持自定义 system prompt 的 agent 产品。
策展与可追溯：frontmatter 里的 contributor、scouted_by、sources、grok_share_url 字段，把"谁写的、谁找的、原始材料在哪、官方分享链接是什么"做了结构化登记，避免提示词被无署名搬运。
API 同步与共建：提供 GET /api/bots、POST /api/bots、POST /api/feedback 等接口，外部 agent 可以全量镜像目录、按 cursor 增量同步，也可以用 owner key 反哺提交。

快速安装（消费侧 / 提交侧两条路）

消费侧：零安装，直接用

# 1. 浏览目录
open https://botdirectory.ai

# 2. 拉取原始 JSON feed（一次性镜像整站）
curl -sSL https://botdirectory.ai/api/bots.json -o bots.json

# 3. 增量同步（cursor-based）
curl -sSL "https://api.botdirectory.ai/api/bots?cursor=start&limit=100"
# 响应里会带 sync.nextCursor，下次用它继续拉

# 4. 仅订阅摘要（轻量，适合"侦察型"agent）
curl -sSL https://botdirectory.ai/updates.json

提交侧：本地起站点并贡献

git clone https://github.com/elie222/botdirectory.ai
cd botdirectory.ai
pnpm install
pnpm dev          # http://localhost:4321
pnpm validate     # 校验 bots/ 下所有文件是否符合契约
pnpm check        # astro check（类型与一致性）
pnpm build        # 静态产物输出到 dist/
pnpm icons        # （可选）为新 integration 下载品牌图标

环境要求：Node 18+、pnpm（仓库自锁版本）、无外部数据库。Astro 静态站 + TypeScript，不依赖前端 UI 框架。

核心用法

1. 一个 bot 文件的最小骨架

bots/seo-improver.md（slug = name 小写、非字母数字转 -）：

---
name: SEO Improver
category: Marketing                  # Productivity / Sales / Marketing / Ops / Success / Personal
added_at: "2026-08-18T12:00:00.000Z" # UTC ISO 8601
contributor: rakazo                  # 可选
integrations: [GitHub, DataForSEO, Search Console]
integration_urls:
  DataForSEO: https://dataforseo.com
grok_share_url: https://x.ai/bot/Y7LbP6p5EBFjfdTp69cKr   # 可选，必须是 x.ai/bot/<id>
sources:                              # 可选，原始材料
  - kind: x
    url: https://x.com/.../status/...
---

You improve my SEO on a schedule. Walk me through connecting GitHub,
DataForSEO and Google Search Console, then every 2 weeks: find pages
losing impressions or sitting on page two, rewrite titles and metadata,
fix internal links, and open a PR I review before merge.

正文必须是第二人称（You…）写成的 agent 指令；只有公开 share 页面而拿不到完整 prompt 时，把简介放进 description，正文留空，站点会标成 Description 而不是 The prompt。

2. 三条贡献路径

Fork + PR：本地写 bots/<slug>.md，CI 校验 frontmatter 与 slug 命名 → 合并即上线。
X mention：在 X 上 @botdirectoryai + 粘贴提示词，mention bot 会代开 PR（added_via 字段会被自动填上 tweet 链接）。
API 投稿：POST /api/bots 走 owner key，写入流程与 PR 等价，但绝不会直接 push main，永远走 PR。

3. JSON API 用法

# 关键词 + 分类 + 排序
curl "https://api.botdirectory.ai/api/bots?q=slack&category=Ops&page=1&limit=25&sort=newest"

# owner 鉴权后查看/提交
curl -H "Authorization: Bearer $OWNER_KEY" https://api.botdirectory.ai/api/me
curl -X POST -H "Authorization: Bearer $OWNER_KEY" \
     -H "Content-Type: application/json" \
     -d @new-bot.json https://api.botdirectory.ai/api/bots

支持参数：q（关键词）、category（六大类之一）、integration（按工具筛选）、page、limit（最大 100）、sort（newest / name）、cursor（增量同步）。limit 超过 100 会被服务端截断。

curl -X POST -H "Content-Type: application/json" \
     -d '{"email":"you@example.com","source":"bot"}' \
     https://api.botdirectory.ai/api/newsletter

endpoint 是 keyless 的，自带去重。

典型适用场景

独立运营 / 增长：把"每周扫一次排名、每月看一眼流失用户、每天扫一次 inbox"这类重复劳动直接抄一个 bot，挂在 Rakazo / Grok Bot 上定时跑。
agent 产品冷启动：用 bots.json / updates.json 作为内置"角色库"，比从零写 system prompt 更快。
提示词策展与署名：在 X、YouTube 上看到好提示词，按 CONTRIBUTING.md 抓成 markdown 提交，scouted_by 字段会给你 credit。
跨 agent 镜像：第三方 agent 平台用 cursor 增量同步整站，做成自己的"现成技能商店"。

坑与注意

slug 命名硬约束：name 小写 + 非字母数字一律转 -，CI 会拒绝不符合的 PR。提交前本地 pnpm validate。
grok_share_url 必须是 https://x.ai/bot/<id>：推文 URL、营销页 URL、其它形状都会被拒绝；没有真实链接时直接省略，不要伪造。这是 x.ai 的 bot sharing terms 强约束。
description ≠ 提示词正文：没拿到完整 system prompt 时，把公开简介放 description、正文留空，站点会自动标成 "Description"，不要试图用简介冒充"完整 prompt"。
category 只有 6 个值：Productivity / Sales / Marketing / Ops / Success / Personal。故意做得很短，不要新增自定义类。
added_at 必须 ISO 8601 UTC：站点和结构化数据的 dateModified 都依赖它，写成 2026-09-21 没有时区会被 CI 拒。
limit 上限 100：超过会被截断，全量镜像请用 https://botdirectory.ai/api/bots.json，增量同步用 cursor=start 起手。
owner key 仅用于写入：POST /api/bots、POST /api/feedback、GET /api/feedback 都需要 Authorization: Bearer … 或 X-API-Key；消费侧全部 read 操作 keyless。
X mention bot 不会直推 main：它开的也是 PR，不是 merge。审核节奏由仓库 owner 控制，不要依赖"发了推就立刻上线"。
集成图标 (pnpm icons) 是可选的：跑了它会下载 data/tool-icons.json 里缺失的图标；不跑也能 build，未收录的工具会显示首字母 monogram 占位。
品牌字符串集中在 src/config.ts：站点名、社交链接、赞助位等都用单一来源，改动后跑一次 pnpm check 防止漏改。

与同类对比

维度	botdirectory.ai	awesome-* 列表（GitHub）	Anthropic 官方 prompt 库	PromptHero / 第三方策展站
形态	一个 bot 一个 .md	单 README 链接列表	闭源 / 注册后下载	闭源 / 站内搜索
提交门槛	极低（fork+PR 或 @X）	中（PR + 描述）	高（需账号、review）	通常不接受投稿
跨 agent 兼容	任意 agent 可粘贴	仅文本，需自己适配	锁定 Anthropic 生态	站内浏览为主
署名 / scouted_by	一等公民	仅 contributor	不公开	站内账号体系
API / 同步	原生 cursor-based JSON	无	无	闭源
版权	MIT（整仓）	多为 CC / 各家自定	服务条款	服务条款

定位：和 awesome-* 一样开放，但结构化 + 提供 API；和官方库一样规范，但中立、可搬走。如果你想要"今天就能用、明天能搬走"的 agent 角色库，它目前是少见的选择。

一句话推荐结论

想给你的 agent 配几个能"定时跑、立刻用、有出处"的角色提示词？先 curl https://botdirectory.ai/api/bots.json 拉一份目录，挑两个跑起来再说——botdirectory.ai 是 2026 年少有的把 agent prompt 做成"开源数据"而非"闭源内容"的目录。

不确定 / 需复核

added_at 字段示例用的 2026-08-18T12:00:00.000Z 直接来自仓库示例，未交叉验证其它 bot 文件的实际取值。
站点当前 bot 总数、category 实际分布未统计；判断"目录规模"需另跑一次 curl https://botdirectory.ai/api/bots.json | jq 'length'。
Grok Bot 的 x.ai/bot/<id> 当前 nanoid 长度（README 示例为 20 字符左右）未从 x.ai 官方文档复核，仅来自仓库示例。
pnpm icons 的实际执行结果（生成哪些 SVG）未本地验证，依赖 README 描述。
仓库显示 Stars 200、周增 +22 为工作队列卡片口径，未在 GitHub 页面二次抓取。