botdirectory.ai README

The project's README from github.com/elie222/botdirectory.ai. As one markdown file: README.md.

botdirectory.ai

A community-maintained directory of ready-to-use agent prompts for Grok Bot, Rakazo, and any agent you already use. Copy a prompt, paste it into your agent, and it sets itself up as a scheduled bot — email triage, daily briefings, SEO fixes, churn warnings, and more.

Live site: botdirectory.ai

botdirectory.ai screenshot

Add your bot in 2 minutes

A bot is one markdown file in bots/:

---
name: SEO Improver
category: Marketing
added_at: "2026-08-18T12:00:00.000Z"
contributor: rakazo
integrations: [GitHub, DataForSEO, Search Console]
integration_urls: { DataForSEO: https://dataforseo.com }
# optional: grok_share_url: https://x.ai/bot/<nanoid-id>  (official Add to Grok Bot link)
---

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.
  1. Fork this repo and add bots/<slug>.md (slug = name, lowercased, non-alphanumerics → -).
  2. Open a pull request. CI validates the file; once merged it's live.

Or skip git entirely: tag @botdirectoryai on X with your prompt and the mention bot opens the PR for you.

Prefer second-person prompts that lead with You…. When you have an official Grok Bot share link on x.ai, set grok_share_url — we surface Add to Grok Bot and never rehost packed configs. If you only have the public share-page blurb (not the private system prompt), put it in frontmatter description and leave the body empty — we label that Description, not The prompt.

Full contract, category list, and quality bar: CONTRIBUTING.md.

Public API

Reads and writes both live on https://api.botdirectory.ai. Full contract: botdirectory.ai/api/.

GET https://api.botdirectory.ai/api/bots returns listings as paginated JSON. It accepts q, category, integration, page, limit (maximum 100), and sort (newest or name). For append-safe synchronization, begin with cursor=start and reuse the returned sync.nextCursor:

https://api.botdirectory.ai/api/bots?q=slack&category=Ops&page=1&limit=25&sort=newest
https://api.botdirectory.ai/api/bots?cursor=start&limit=100

For mirroring the whole directory in one request, use the canonical raw feed at https://botdirectory.ai/api/bots.json.

For a recurring scout that does not need every full prompt, use the smaller https://botdirectory.ai/updates.json feed. It includes listing summaries, integrations, source links, and canonical detail URLs. The copy-paste setup at botdirectory.ai/connect/ gives an agent a safe seen-item workflow around that feed.

Writes need an account. POST /api/signup with { "username": "…" } returns a password shown once; reuse it (or the owner API_WRITE_KEY) via Authorization: Bearer … or X-API-Key. Then:

People and bots can subscribe a known user email to curated bot drops with POST /api/newsletter and { "email": "[email protected]", "source": "bot" }. The endpoint is keyless and safely deduplicates addresses.

Local dev

Astro static site, TypeScript, pnpm, no UI framework.

pnpm install
pnpm dev        # http://localhost:4321
pnpm build      # static build in dist/
pnpm validate   # check every file in bots/
pnpm check      # astro check (types)

Sponsoring

Sponsor slots (the rail next to the list) are monthly and capped. See the sponsor section on the site.

License

MIT © 2026 Inbox Zero Inc.

botdirectory.ai (elie222/botdirectory.ai)

Searching Database…

Что это?Каталог готовых промптов для агентов, поддерживаемый сообществом, — для Grok Bot, Rakazo и любых других агентов: скопируйте промпт и вставьте его в своего агента, чтобы превратить в бота по расписанию для сортировки почты, ежедневных сводок, SEO-правок или предупреждений об оттоке клиентов.
Это сам бот или просто список промптов?Это статический сайт (построенный на Astro), где промпты для ботов лежат в виде markdown-файлов, плюс публичный JSON API — сам по себе он не среда выполнения агентов: вы копируете промпт и запускаете его в своём агенте.
Как добавить своего бота в каталог?Сделайте форк репозитория и добавьте один markdown-файл в bots/, назвав его по имени бота в нижнем регистре и slug-виде, затем откройте pull request — CI его проверит, и после слияния он появится в каталоге. Можно и без git: упомяните @botdirectoryai на X со своим промптом, и бот упоминаний сам откроет PR.
На чём построен локальный dev-стек?Это обычный статический сайт на Astro, написанный на TypeScript и управляемый через pnpm — UI-фреймворк не используется.
Можно ли напрямую загрузить приватный конфиг Grok Bot?Нет — кнопка «Add to Grok Bot» появляется только у официальных публичных ссылок (grokshareurl на x.ai); запакованные приватные конфиги никогда не перезаливаются, а если у вас только текст с публичной страницы шаринга, он помечается как «Description», а не «The prompt».
Что можно делать с публичным API для чтения?GET-запросы возвращают постраничные JSON-списки с фильтрами q, category, integration, page, limit (максимум 100) и sort (newest или name); есть также канонический raw-фид для зеркалирования всего каталога и уменьшенный summary-фид для лёгкого опроса с настройкой синхронизации уже полученных элементов на botdirectory.ai/connect/.
Как получить доступ на запись, чтобы отправить бота или отзыв через API?POST /api/signup с именем пользователя даёт одноразовый пароль, затем используйте его (или владельческий API write key) как Bearer-токен или X-API-Key при вызовах POST /api/bots (открывает PR, никогда не пушит в main) или POST /api/feedback.
Можно ли подписаться на обновления ботов без создания аккаунта?Да — POST /api/newsletter с email и source не требует ключей и безопасно дедуплицирует адреса, так что подписываться на курируемые подборки ботов могут и люди, и боты.
Что такое Rakazo?Rakazo — ещё одна агентная платформа, которую каталог поддерживает наряду с Grok Bot и любыми другими агентами, но в README нет подробностей о том, что делает сам Rakazo.
Creator
elie222
Size
13.5 MB
Stars
260
Updated
CommitOct 16
Age
2mo
Commits · 90 Days