Skip to content
Back to search

seoforagent

MarketplaceWorks with Claude CodeGitHub

SEOforAgent: the SEO tool for AI agents, by Outrank. Site, dashboard, MCP server and skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Outrank-SAS/seoforagent with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Outrank-SAS/seoforagent'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/outrank-sas--seoforagent/badge.svg)](/listings/outrank-sas--seoforagent)

HTML

<a href="/listings/outrank-sas--seoforagent"><img src="/api/listings/outrank-sas--seoforagent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "seoforagent",
  3. "owner": { "name": "Outrank", "email": "support@outrank.so" },
  4. "plugins": [
  5. {
  6. "name": "seoforagent",
  7. "source": "./plugin",
  8. "description": "SEOforAgent MCP server and skills: SEO data, AI visibility, listicle hunt and backlinks, priced in dollars."
  9. }
  10. ]
  11. }
README.md · README · 137 lines
  1. # SEOforAgent
  2. The SEO tool for AI agents, by [Outrank](https://www.outrank.so). Connect it to Claude, ChatGPT, Codex or Cursor and your agent gets keyword and search data, AI visibility checks across ChatGPT, Perplexity, Gemini and Claude, a listicle hunt, and backlinks and listicle placements bought through Outrank. Every call is priced in US dollars and reports what it cost.
  3. This repository is the client: the website at [seoforagent.com](https://seoforagent.com), the dashboard at `/app`, the hosted MCP server at `/mcp`, the REST proxy at `/api/v1`, the agent skills and the Claude Code plugin. It is MIT licensed. **The service itself (data, billing, accounts, backlink matching) is hosted by Outrank and is not part of this repository.** Every request is forwarded to the Outrank agent API.
  4. ## Get started
  5. 1. Open [seoforagent.com](https://seoforagent.com). An API key (`sfa_live_...`) is generated in your browser.
  6. 2. Click Activate, pick a plan (from $9 a month) or buy credit once (from $10), and pay on Stripe.
  7. 3. Connect your agent, then paste the setup prompt from the homepage or [/setup.md](https://seoforagent.com/setup.md).
  8. ### Claude Code
  9. ```sh
  10. claude mcp add --transport http seoforagent https://seoforagent.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
  11. ```
  12. Or install the plugin, which adds the MCP server and the skills:
  13. ```sh
  14. export SEOFORAGENT_API_KEY=sfa_live_...
  15. claude plugin marketplace add Outrank-SAS/seoforagent
  16. claude plugin install seoforagent@seoforagent
  17. ```
  18. ### Codex (`~/.codex/config.toml`)
  19. ```toml
  20. [mcp_servers.seoforagent]
  21. url = "https://seoforagent.com/mcp"
  22. http_headers = { Authorization = "Bearer <YOUR_API_KEY>" }
  23. ```
  24. ### Cursor (`~/.cursor/mcp.json`)
  25. ```json
  26. {
  27. "mcpServers": {
  28. "seoforagent": {
  29. "url": "https://seoforagent.com/mcp",
  30. "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
  31. }
  32. }
  33. }
  34. ```
  35. ### Claude app and ChatGPT
  36. These apps cannot set headers, so the key goes in the URL: `https://seoforagent.com/mcp/<YOUR_API_KEY>`. Keep that URL private.
  37. - Claude: Settings, Connectors, Add custom connector, paste the URL.
  38. - ChatGPT: Settings, Apps and connectors, Advanced settings, turn on developer mode, Create, paste the URL, No authentication.
  39. ## Tools
  40. | Area | Tools |
  41. |---|---|
  42. | Account | `whoami`, `wallet_get`, `pricing_get`, `account_link`, `results_get`, `results_share` |
  43. | Projects | `projects_list`, `projects_create`, `projects_get`, `projects_update` |
  44. | Search Console | `gsc_connect`, `gsc_performance` |
  45. | Keywords and search results | `keywords_research`, `keywords_metrics`, `serp_results`, `serp_competitors` |
  46. | Domains | `domain_overview`, `domain_keywords` |
  47. | Rank tracking | `rank_check`, `rank_history` |
  48. | Scheduled tracking | `tracking_get`, `tracking_set` |
  49. | AI visibility | `ai_visibility_check` |
  50. | Listicle hunt | `listicles_find`, `listicles_list`, `listicles_get`, `listicles_pitch` |
  51. | Backlinks | `backlinks_profile`, `backlinks_gap`, `backlinks_suggest`, `backlinks_buying_get`, `backlinks_buying_set`, `backlinks_placements`, `backlinks_quote`, `backlinks_allocate` |
  52. All tools are defined in one registry, [`lib/tools.ts`](lib/tools.ts): name, description, price, zod input schema, HTTP method and route, and kind (read, paid, write or money). Paid tools accept `dry_run`, `max_cost_usd` and `fresh`. `backlinks_allocate` moves money: it needs a `quote_id` and the exact `confirm_usd`, sends an `Idempotency-Key`, and is annotated `destructiveHint: true`. `backlinks_buying_set` controls two products paid from the same backlink credits ($0.80 each): backlinks (a contextual link inside an article, DR × 2 credits, $64 at DR 40, at most 2 a day) and listicles (the brand placed in a "best X" list article, DR × 4 credits, $128 at DR 40). Each has its own switch and monthly credit budget. Full reference: [/docs](https://seoforagent.com/docs) or [/docs.md](https://seoforagent.com/docs.md).
  53. ## Skills
  54. In [`skills/`](skills), each a Markdown workflow that states its expected spend and stops to ask before going over it: `seo-setup`, `keyword-plan`, `ai-visibility-audit`, `listicle-hunt`, `link-building`, `weekly-review`. The plugin in [`plugin/`](plugin) links to them.
  55. ## How it works
  56. ```
  57. agent ──MCP──▶ seoforagent.com/mcp ─┐
  58. browser ─────▶ seoforagent.com/api/v1/* ─┼──▶ www.outrank.so/api/agent/v1/*
  59. │
  60. dashboard (/app, key in localStorage) ┘
  61. ```
  62. - `app/mcp/route.ts` and `app/mcp/[key]/route.ts`: stateless Streamable HTTP MCP server. A fresh `McpServer` per request, JSON responses, `GET` and `DELETE` answer 405. The key comes from `Authorization: Bearer` or the path. Without a key, tools list but calls return a message pointing to seoforagent.com (except `pricing_get`, which is public).
  63. - `app/api/v1/[...path]/route.ts`: forwards GET, POST, PUT, PATCH and DELETE with the query string, body, `Authorization`, `Content-Type`, `Idempotency-Key` and the client's `X-Forwarded-For`. It also sets `x-sfa-client-ip` to the visitor IP and, when `SFA_PROXY_SECRET` is set, `x-sfa-proxy-secret`, so Outrank can trust that IP for the free lookup limit; values of those two headers sent by a browser are never forwarded. Status, body and content type come back unchanged. `maxDuration` is 300 seconds because listicle hunts can take about 90.
  64. - The homepage generates the key in the browser (`sfa_live_` + base64url of 32 random bytes) and keeps it in `localStorage` (`sfa_pending_key`, then `sfa_key` once active). Nothing is sent until Activate.
  65. - `app/r/[token]`: the public page of a result shared with `results_share` (AI visibility checks and listicle hunts), with its own link preview image. Not indexed.
  66. - `app/for/[agent]` and `app/vs/openseo`: pages for search. `app/launch-demo` is a 1200 by 675 stage that plays a 25-second session, for screen recording.
  67. - [`cli/`](cli): the `seoforagent` npm package (`npx seoforagent init`), no dependencies. The site mentions it only when `NEXT_PUBLIC_CLI_PUBLISHED` is `true`.
  68. - Tool results over MCP: `content` is the JSON envelope, with arrays over 25 items trimmed and a pointer to `results_get`; `structuredContent` is the full envelope.
  69. ## Environment variables
  70. Only `SFA_PROXY_SECRET` is secret. See [`.env.example`](.env.example).
  71. | Name | Default | Purpose |
  72. |---|---|---|
  73. | `OUTRANK_API_BASE` | `https://www.outrank.so/api/agent/v1` | Backend every request is forwarded to |
  74. | `NEXT_PUBLIC_SITE_URL` | `https://seoforagent.com` | Public origin used in prompts, MCP URLs, sitemap and metadata |
  75. | `NEXT_PUBLIC_POSTHOG_KEY` | empty | Optional PostHog project key. Without it no analytics load |
  76. | `NEXT_PUBLIC_REWARDFUL_KEY` | empty | Optional Rewardful key. Without it no affiliate tracking loads |
  77. | `NEXT_PUBLIC_GITHUB_PUBLIC` | empty | `true` shows the GitHub link and the star count |
  78. | `NEXT_PUBLIC_CLI_PUBLISHED` | empty | `true` shows `npx seoforagent init` in the setup card and the docs |
  79. | `SFA_PROXY_SECRET` | empty | Server only. Sent to Outrank as `x-sfa-proxy-secret` so it trusts `x-sfa-client-ip` |
  80. ## Local development
  81. Requires Node 22.
  82. ```sh
  83. npm install
  84. cp .env.example .env.local
  85. npm run dev # http://localhost:3000
  86. npm test # registry and formatter unit tests
  87. npm run lint
  88. npm run typecheck
  89. npm run build
  90. ```
  91. Check the MCP server:
  92. ```sh
  93. curl -s http://localhost:3000/mcp \
  94. -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  95. -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
  96. ```
  97. To point at a local Outrank, set `OUTRANK_API_BASE=http://localhost:3001/api/agent/v1`.
  98. ## Deploy
  99. Vercel, Next.js preset, Node 22. Set the environment variables above. The MCP and proxy routes run on the Node.js runtime with `maxDuration = 300`, which needs a plan that allows it (Fluid compute). Point `seoforagent.com` at the project. `server.json` is the MCP registry manifest; publishing it under `com.seoforagent/seoforagent` needs DNS or HTTP verification of seoforagent.com.
  100. ## License
  101. MIT, see [LICENSE](LICENSE). The client is open source. The service runs on Outrank and is covered by [Outrank's terms](https://www.outrank.so/terms).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.