scrapeops-setup

name	scrapeops-setup
description	Configure the ScrapeOps plugin. Use when the user asks to "configure scrapeops", "setup scrapeops", "set api key", "set scrapeops key", "scrapeops config", or when a ScrapeOps skill reports that the API key is missing.
argument-hint	["api_key"]
version	3.0.0

ScrapeOps — Setup Skill

Configures the ScrapeOps plugin by saving the API key to ~/.claude/settings.json as an environment variable. Claude Code injects this automatically into every session.

---

Step 1 — Check current configuration

Read ~/.claude/settings.json with the Read tool and check if env.SCRAPEOPS_API_KEY exists.

If already configured, show:

ScrapeOps is already configured.

  API Key: <first 8 chars>••••••••
  Backend: <SCRAPEOPS_API_URL value or "https://parser.scrapeops.io (default)">

To update the key, run: /scrapeops-setup <new_api_key>

Then stop.

---

Step 2 — Get the API key

If an api_key argument was passed (e.g. /scrapeops-setup abc123), use it directly — skip asking.

If the key is missing, ask:

Enter your ScrapeOps API key (find it at https://scrapeops.io/app/dashboard):

---

Step 3 — Save to ~/.claude/settings.json

Read ~/.claude/settings.json with the Read tool.

The file may or may not have an env section. Add or update SCRAPEOPS_API_KEY inside env:

{
  "env": {
    "SCRAPEOPS_API_KEY": "<the_api_key>"
  }
}

Use the Edit tool to make the change. Preserve all other existing keys — only touch SCRAPEOPS_API_KEY.

If ~/.claude/settings.json does not exist, create it with the Write tool:

{
  "env": {
    "SCRAPEOPS_API_KEY": "<the_api_key>"
  }
}

---

Step 4 — Confirm

Show:

✓ ScrapeOps configured successfully!

  API Key: <first 8 chars>••••••••
  Backend: https://parser.scrapeops.io (default)

You can now use /generate-scraper, /fix-scraper, and /generate-crawler-scraper.

---

Notes

• The API key is stored in ~/.claude/settings.json under env.SCRAPEOPS_API_KEY. Claude Code injects it as an environment variable automatically — no manual MCP setup needed.
• To use a local backend (developers only), manually add SCRAPEOPS_API_URL to the env section in ~/.claude/settings.json.
• The MCP server (mcp-server/index.js) has zero dependencies and starts automatically — no npm install needed.