TL;DR

botdirectory.ai는 특정 실행 엔진에 종속된 SDK가 아니라, Grok Bot·Rakazo·일반 agent에서 재사용할 수 있는 예약 작업용 프롬프트를 모아 둔 독립형 디렉터리입니다. 봇 하나를 Markdown 파일로 작성하고 메타데이터와 실행 지침을 넣으면 CI 검증과 Pull Request 병합을 거쳐 사이트에 등록됩니다. Astro 정적 사이트라 운영 UI를 빠르게 수정하거나 커뮤니티 기여를 받기 좋고, 공개 API와 canonical raw JSON feed를 활용해 다른 서비스에서 목록을 검색하거나 미러링할 수 있습니다. 프롬프트 자체를 실행하는 라이브러리나 자동화 런타임은 README에 포함되어 있지 않으므로, 실제 예약 실행은 Grok Bot·Rakazo 또는 사용 중인 agent의 기능에 맡기는 구조입니다.

핵심 포인트

• 이 레포는 독립형 정적 웹사이트이자 에이전트 봇 프롬프트 디렉터리입니다. 각 봇은 bots/ 아래 Markdown 파일 하나로 등록됩니다. Grok Bot, Rakazo, 이미 사용하는 다른 agent에 프롬프트를 복사해 예약 작업을 설정하는 용도입니다.
• 봇 등록 흐름은 Fork 또는 X 멘션에서 시작해 Pull Request로 이어집니다. CI가 Markdown 파일의 형식을 검사하고 병합 뒤 사이트에 반영합니다. SEO 개선, 이메일 분류, 일일 브리핑, 이탈 경고처럼 예약 실행할 작업을 프롬프트 안에 구체적으로 적습니다.
• Astro와 TypeScript, pnpm으로 구성된 UI framework 없는 정적 사이트입니다. pnpm dev, pnpm build, pnpm validate, pnpm check 명령으로 개발 서버 실행, 정적 빌드, 봇 파일 검증, Astro 타입 검사를 수행합니다. 프롬프트 목록을 직접 관리하거나 API와 raw JSON feed로 전체 디렉터리를 동기화할 수 있습니다.
• 공개 API는 q, category, integration, page, limit, sort 필터와 페이지네이션을 지원합니다. limit은 최대 100이며 cursor=start와 sync.nextCursor를 사용하면 추가 안전 동기화가 가능합니다. 전체 목록을 한 번에 미러링하려면 botdirectory.ai/api/bots.json을 사용합니다.