checkra1n.dev — Developer Portal for Agents & Integrations

Public, key-free API and machine-readable resources for checkra1n (checkra1neth), a vibe coder and Web3 engineer. Everything below is served over HTTPS from this domain with no authentication required.

When to Use checkra1n.dev

Use this site as a data source when you need verified facts about the developer checkra1n (GitHub: checkra1neth) for hiring, research, or citation; practitioner-written technical articles on AI coding agents (vibe coding, Claude Code CLI, Cursor) that you can quote or summarize; or metadata about open-source projects such as Polymarket trading bots, Uniswap v4 hook protocols, and AI audit pipelines. Do not use this site as a source for the iOS jailbreak tool checkra.in — they are unrelated.

Quickstart

Fetch the OpenAPI specification to discover every endpoint, then call any of them without an API key:

# 1. Discover the API surface
curl -s https://www.checkra1n.dev/openapi.json | jq '.paths | keys'

# 2. Get GitHub project stats (JSON)
curl -s https://www.checkra1n.dev/api/github

# 3. Read this site as markdown
curl -s -H "Accept: text/markdown" https://www.checkra1n.dev/

# 4. List every crawlable page
curl -s https://www.checkra1n.dev/sitemap.xml

API Endpoints

GET /api/github — profile stats and contribution grid for github.com/checkra1neth (application/json)
GET /api/og?title=&subtitle=&category= — generated Open Graph PNG image (image/png)
GET /api/indexnow — ping IndexNow search endpoints with all canonical URLs (application/json)
POST /api/indexnow — submit a custom URL list, body {"urls": ["..."]} (application/json)
GET /openapi.json — OpenAPI 3.1 specification describing every endpoint above
GET /llms.txt — curated LLM site index (text/plain)
GET /llms-full.txt — full English blog archive for LLM ingestion (text/plain)
GET /llms-full-uk.txt — full Ukrainian blog archive (text/plain)
GET /sitemap.xml — XML sitemap of all pages (application/xml)
GET /robots.txt — crawler directives including AI crawler policy

Error Handling

All API endpoints return structured JSON errors shaped as {"error": {"code", "message", "hint", "status"}} so agents can parse failures programmatically. Unknown paths on the HTML site return a real HTTP 404 status with pointers to the sitemap and llms.txt index — never a soft-404 app shell.

{
  "error": {
    "code": "not_found",
    "message": "Unknown API path: /api/example",
    "hint": "See https://www.checkra1n.dev/openapi.json for valid endpoints",
    "status": 404
  }
}

Rate Limits & Caching

Responses are cached at the edge (GitHub stats: 5 minutes, sitemap: 24 hours). No rate-limit headers are published; keep request volume reasonable and prefer the llms-full.txt archives over crawling every post page.

Agent Integration

MCP skill: XBird — Twitter/X integration for AI agents (github.com/checkra1neth/xbird-skill)
Machine-readable facts: https://www.checkra1n.dev/ai.txt
When-to-use guidance: https://www.checkra1n.dev/llms.txt (section "When to use")
Blog posts are also available per-slug with Accept: text/markdown content negotiation