Skip to main content
SSSuperScraper
Live

Agents and MCP

Your agent creates its own key, learns the API from llms.txt and a skill file, and calls it over REST.

Get an API keyRead the docs

Endpoints

  • POST/v1/keys/provisionCreates a Free key with no signup. Rate limited per IP address.
  • GET/agent-onboarding/SKILL.mdOne skill file that teaches an agent the whole API.
  • GET/llms.txtA short, machine-readable index of what the API does.

Try it

Pick your coding agent to copy a setup prompt. The agent reads our llms.txt and auth.md, creates its own key and makes one test call.

# 1. The agent mints its own key, no human signup
curl -X POST https://api.superscraper.dev/v1/keys/provision \
  -H "Content-Type: application/json" \
  -d '{ "label": "research-agent" }'
# → { "apiKey": "ss_live_...", "tier": "free" }

# 2. Use it immediately, fetch + trust the result
curl -X POST https://api.superscraper.dev/v1/scrape \
  -H "Authorization: Bearer ss_live_..." \
  -d '{ "url": "https://example.com", "formats": ["markdown"] }'
# → { "markdown": "...", "metadata": { "completeness": 0.97, "extractionMethod": "json-ld" } }

What it returns

POST /v1/keys/provision

Response fields for POST /v1/keys/provision
apiKeyThe new key. It is shown once.On 201
tierAlways free for a provisioned key.On 201
creditsThe monthly grant (scrape, enrich) and credits.state: ok, grant_pending, grant_failed or reconciling.On 201
quotaMonthly page and extraction limits for the plan.On 201
noteWhere to upgrade: POST /v1/billing/checkout.On 201

Too many requests from one address return 429.

One request

Send your key as a Bearer token. Every parameter in these samples is one the endpoint reads today. The Example tab shows a trimmed response for a fictional business.

Every parameter in the docs
curl -X POST https://api.superscraper.dev/v1/keys/provision \
  -H "Content-Type: application/json" \
  -d '{
    "label": "research-agent"
  }'

Pricing

Compare the plans
  • Creating a key costs nothing. A new key is on the Free plan, with 1,000 credits a month.
  • Each call then costs what its product page lists.

Questions

Does a person have to sign up first?

No. POST /v1/keys/provision with no key creates a Free key. Requests are rate limited per IP address.

Is there a hosted MCP server?

Not yet, it is coming soon. Today agents call the REST API, and developers can run the MCP server locally over stdio.

Where should the agent keep its key?

In an environment variable such as SUPERSCRAPER_API_KEY. The key is shown once, and it belongs outside code, commits and logs.

Coming soon

  • Hosted MCPComing soon

Not callable yet. Beta items open as beta first.

Built with it

Other products