Developers
Let your agent do the SEO work
Connect Claude, Cursor or any MCP client to SEOmade. It can audit your site, fix what it finds, submit your product to directories and record what happened. There is a REST API too, and one key works for both.
Connect in one command Install guide for agents Agent skill OpenAPI spec
What your agent can do
Copy a prompt, paste it into your agent, and it does the rest.
- Audit the site and fix it
Runs the 48-check audit, reads the fix list in order of value, then makes the changes in your codebase.
run_site_auditget_site_audit - Submit to directories
Picks the next directories that fit, gets the exact value for each form field, fills the form in its own browser and records the result.
next_submissionsget_submission_kitset_submission_status - Write the product profile once
Drafts your tagline, descriptions and category from your site, asks you for what is missing, and saves it for every later form.
get_product_profilesave_product_profile - Run any of 41 SEO checks
Redirects, indexability, rich results, llms.txt, internal links and more, on any public URL.
list_seo_toolsrun_seo_tool - Research directories
Searches 1104 ranked directories by niche, Domain Rating, link type and price.
search_directoriesget_directorycatalog_meta
1Your API key
Sign in and subscribe to get a key.
Sign in2Connect
claude mcp add --transport http seomade https://seomade.app/api/mcp \
--header "Authorization: Bearer __SEOMADE_KEY__" Run this once in your terminal. Then just ask Claude about directories.
{
"mcpServers": {
"seomade": {
"url": "https://seomade.app/api/mcp",
"headers": {
"Authorization": "Bearer __SEOMADE_KEY__"
}
}
}
} Paste into ~/.cursor/mcp.json (or Cursor Settings → MCP → Add). Other MCP clients use the same URL and header.
curl "https://seomade.app/api/v1/directories?collection=saas&dofollow=true&free=true&limit=10" \
-H "Authorization: Bearer __SEOMADE_KEY__" Plain REST. Same key.
const res = await fetch(
"https://seomade.app/api/v1/directories?collection=saas&dofollow=true&limit=5",
{ headers: { Authorization: "Bearer __SEOMADE_KEY__" } },
);
const { results } = await res.json();
console.log(results.map((d) => `${d.name} (DR ${d.dr})`)); Works in Node 18+, Deno, Bun and the browser.
3Try it
Paste any prompt from the list above into your agent. A good first one:
- “Audit my site with SEOmade and tell me the three fixes worth the most.”
Or check a key works right here:
Reference
REST endpoints
Base URL https://seomade.app/api/v1. Send Authorization: Bearer sm_live_…
(or X-API-Key).
GET /directories | Filtered list |
GET /directories/{slug} | One directory in full |
GET /meta | Categories, collections, your quota |
Filters for /directories
q | Search name, host or summary |
collection | good, top or saas |
category | e.g. AI Tools |
dofollow, free | true / false |
min_dr, max_dr | 0–100 |
link_type, pricing | Dofollow/Nofollow, Free/Paid |
quality_tier, saas_fit, goal | Editorial fit |
sort | rank, dr, name, score |
limit, offset | Paging (max 100 per page) |
MCP tools
Server URL https://seomade.app/api/mcp, same key. Catalog tools are read-only; project tools act on your own projects.
search_directories | Shortlist by niche, DR, dofollow, free/paid |
get_directory | Full details for one directory |
catalog_meta | Categories, collections, remaining quota |
list_projects | Your products, their DR and submission counts |
get_product_profile | The answers forms ask for, and what is missing |
save_product_profile | Set or change profile fields |
next_submissions | The next directories in your plan, skipping what is done |
get_submission_kit | Field values, length-fitted text and rules for one directory |
set_submission_status | Record submitted, pending, live or rejected |
run_site_audit | Three scores (SEO, AI Search, Agent Readiness) and every issue with its fix |
get_site_audit | The latest saved audit, without re-running |
list_seo_tools | The SEO tools and their parameters |
run_seo_tool | Run one tool on any public URL, or a generator |
An agent with its own browser can fill submission forms from the kit. It asks you before paying, creating accounts or solving CAPTCHAs. Prompts: fix_my_seo, submit_to_directories, prepare_product_profile.
Limits
10,000 requests a day, reset at midnight UTC. Only real calls count — the MCP handshake is free. Up to 10 keys per account.