Welcome

Ray9 is an SEO data API. Plug it into your agent as a hosted MCP server, or call it directly over HTTPS. SERP is shipping today; keywords, backlinks, on-page, and AI-search are landing through the year.

✨ Why Ray9

• 🧠 Shaped for agents — stable field names, balance returned inline (no second /usage round-trip), no opaque data: {…} envelope.
• 🔌 MCP-native — your coding agent picks up Ray9's tools directly. No glue code, no SDK to update.
• 🧱 Predictable errors — single envelope (code, message, requestId) so agents branch on failure modes instead of parsing prose.
• 💳 Simple credits — $1 free on signup, $5 PayG floor. No seats, no monthly minimum.

📊 Search Data

The endpoints that map to what you'd want from an SEO data API. SERP is shipping; the rest are landing through the year.

• 🔍 SERP (Rank Tracking) — Google SERP for any keyword: organic listings, AI Overviews, featured snippets, knowledge panels, "people also ask", local pack. Country, language, and device scoping. The same primitive for one-off position checks and scheduled rank tracking.
• 🎯 Keywords (in development) — bulk keyword metrics (volume, difficulty, intent, SERP-feature presence) and seed expansion into clustered, ready-to-publish content plans.
• 🔗 Backlinks (in development) — referring domains and pages, anchor-text distribution, follow / nofollow state, and lost / new movement since the last snapshot.
• 📄 On-Page (in development) — single-URL audit: title, meta, headings, schema validity, internal-link graph, content depth, and the post-render DOM as Google sees it.
• 🤖 AI Search (in development) — query ChatGPT, Perplexity, Claude, Gemini, AI Overviews, and Copilot the way SERP queries Google. Answer text plus cited sources, normalised across engines.

⚡ Try it

Add Ray9 to your MCP-aware client (Cursor, Claude Desktop, VS Code, Goose, Windsurf):

{
  "mcpServers": {
    "ray9": {
      "url": "https://api.ray9.ai/mcp",
      "headers": {
        "Authorization": "Bearer rk_…"
      }
    }
  }
}

Restart the client and your agent picks up serp.search and usage.get as native tools.

Don't have a key yet? See Quick start for signup, key creation, and the curl path.

🛠 Clients

Four ways to call Ray9. MCP and the API are live today; CLI and agent skills are landing soon.

• 🧩 MCP — coding agents (Claude Desktop, Cursor, VS Code, Goose, Windsurf) calling Ray9 as native tools.
• 🌐 API — curl, fetch, any HTTP client. Send Authorization: Bearer rk_….
• 🔧 CLI (in development) — terminal client; pipe results into jq, script queries, profiles per env.
• 📦 Agent skills (in development) — pre-packaged action recipes for Claude Code, Codex, and similar agents.

📚 Concepts

Cross-cutting behaviour that applies to every endpoint and client:

• Authentication — rk_ keys, lifecycle, rotation.
• Errors — the canonical envelope, code reference, retry guidance.
• Rate limits — per-org bucket, 60/min, shared across clients.
• Billing — credits, $1 free grant, $5 PayG minimum.

💬 Help

Hit a wall? Email contact@ray9.ai with the response's requestId (when you have one). See also Troubleshooting, FAQ, Support.