# Claude Code

### Prerequisites

* ScraperAPI account
* Claude Code installed
* Claude account

### Setup

If you don't have an account with us yet, head over to [scraperapi.com](https://www.scraperapi.com/) to create one and grab your API key from the [Dashboard](https://dashboard.scraperapi.com/home) area. You will need it to authenticate the requests that your LLM client will be making.

**Configuration for Claude Code:**

{% tabs %}
{% tab title="Manually" %}
Add the server manually to your `.claude/settings.json` by pasting the contents below

```json
{
  "mcpServers": {
    "ScraperAPIRemote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.scraperapi.com/mcp",
        "--header",
        "Authorization: Bearer {YOUR_API_KEY}"
      ]
    }
  }
}
```

{% endtab %}

{% tab title="Via CLI" %}

```bash
claude mcp add scraperapi -- npx mcp-remote https://mcp.scraperapi.com/mcp --header "Authorization: Bearer {YOUR_API_KEY}"
```

{% endtab %}
{% endtabs %}

### Parameters

| **`scrape`** (required)        | Tells the LLM to scrape a URL from the internet using ScraperAPI.                                                                                                                                                                        |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`url`** (requierd)           | URL you wish to scrape.                                                                                                                                                                                                                  |
| **`render`** (optional)        | Defaults to **`False`**. Set to **`True`** if the page requires JavaScript rendering to display its contents.                                                                                                                            |
| **`country_code`** (optional)  | Activate country geotargeting (e.g. “us”, “es”, “uk”, etc.).                                                                                                                                                                             |
| **`premium`** (optional)       | Set to **`True`** to use residential IPs with your scrapes.                                                                                                                                                                              |
| **`ultra_premium`** (optional) | Activates advanced bypass mechanisms when set to **`True`**. Can **not** be combined with **`premium`**.                                                                                                                                 |
| **`device_type`** (optional)   | Defaults to **`desktop`**.  Set to **`mobile`** to use mobile user agents with the scrapes.                                                                                                                                              |
| **`output_format`** (optional) | <p>Instructs the API on what the response file type should be. Defaul is HTML. Valid options:<br>- markdown<br>- text<br>- json (for a <a href="https://docs.scraperapi.com/structured-data-endpoints/overview">list</a> of domains)</p> |
| **`autoparse`** (optional)     | Boolean. Activate auto parsing for a [list](https://docs.scraperapi.com/structured-data-endpoints/overview) of supported domains. Defaults to `False`. Set to `True` only if you want the output format in csv or json.                  |

### Prompt Example

<mark style="background-color:blue;">Ger proerpty listing details from Redfin</mark>

*- "Get the prices of all properties listed on the first page of Redfin results for Queens."*

#### Response

The task was to get property prices from the first page of Redfin results for Queens, NY. The ScraperAPI MCP skill&#x20;provides a dedicated `redfin_search` tool for exactly this. It returns structured listing data (price, address,&#x20;beds/baths, etc.) directly without needing to scrape and parse raw HTML. Claude correctly selected the `redfin_search` tool:

```json
{
  "tool": "mcp__scraperapi__redfin_search",
  "parameters": {
    "url": "https://www.redfin.com/city/30749/NY/Queens",
    "countryCode": "us"
  }
}
```

<figure><img src="https://921583510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXJv4kz1e8RdAq9HrFwyo%2Fuploads%2FOSHLnKeBg4sIhFFlJXBx%2Fimage.png?alt=media&#x26;token=029171bd-66fd-44ed-85d7-b35337489d94" alt=""><figcaption></figcaption></figure>

*"41 listings total (2 were ads, excluded). Queens-specific listings are marked with (Queens). Redfin's Queens search page surfaces results from across the broader NYC metro area. Prices range from $182,367 (Bronx co-op) to&#x20;$8,900,000 (Manhattan townhouse)."*

<details>

<summary>RedfinQueensListings.md</summary>

```markdown
 ┌─────┬─────────────────────────────────────────────────────────────┬────────────┬────────────┐
  │  #  │                           Address                           │ Beds/Baths │   Price    │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 1   │ 445 E 46th St, Brooklyn, NY 11203                           │ 4bd/3ba    │ $999,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 2   │ 58-68 41st Dr, Woodside, NY 11377 (Queens)                  │ 3bd/1.5ba  │ $1,188,888 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 3   │ 202 Bay 34th St, Brooklyn, NY 11214                         │ 3bd/2ba    │ $1,250,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 4   │ 3304 Bouck Ave, Bronx, NY 10469                             │ 4bd/2.5ba  │ $665,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 5   │ 183 Arlington Pl, Staten Island, NY 10303                   │ 3bd/1ba    │ $549,999   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 6   │ 303 W 113th St, New York, NY 10026                          │ 4bd/4ba    │ $3,495,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 7   │ 61-25 98th St Unit 9F, Rego Park, NY 11374 (Queens)         │ 1bd/1ba    │ $329,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 8   │ 159 Madison Ave Unit 10ABC, New York, NY 10016              │ 4bd/3ba    │ $2,495,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 9   │ 327A Mersereau Ave, Staten Island, NY 10303                 │ 2bd/1.5ba  │ $436,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 10  │ 1163 Rhinelander Ave, Bronx, NY 10461                       │ 4bd/3ba    │ $1,149,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 11  │ 31 Jane St Unit 9AB, New York, NY 10014                     │ 2bd/2ba    │ $2,300,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 12  │ 35 W 11th St, New York, NY 10011                            │ 7bd/7.5ba  │ $8,900,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 13  │ 89-27 172nd St, Jamaica, NY 11432 (Queens)                  │ 6bd/3ba    │ $1,399,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 14  │ 104 E 37th St Unit 3E, New York, NY 10016                   │ Studio/1ba │ $350,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 15  │ 2031 New York Ave, Brooklyn, NY 11210                       │ 3bd/2ba    │ $1,050,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 16  │ 60-11 Broadway Unit 6K, Woodside, NY 11377 (Queens)         │ 2bd/1ba    │ $495,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 17  │ 60 Knolls Cres Unit 4H, Bronx, NY 10463                     │ 2bd/1ba    │ $182,367   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 18  │ 525 S 11th Ave, Mount Vernon, NY 10550                      │ —/—        │ $545,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 19  │ 2711 Avenue X Unit 6D, Brooklyn, NY 11235                   │ 1bd/1ba    │ $289,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 20  │ 32 Aspen Knolls Way, Staten Island, NY 10312                │ 2bd/1.5ba  │ $518,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 21  │ 345 W 55th St Unit 1C, New York, NY 10019                   │ 1bd/1ba    │ $525,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 22  │ 1668 Nostrand Ave, Brooklyn, NY 11226                       │ 8bd/3ba    │ $2,200,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 23  │ 1469 West Ave Unit 1F, Bronx, NY 10462                      │ 1bd/1ba    │ $290,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 24  │ 111 W 56th St Unit 39L, New York, NY 10019                  │ 2bd/2.5ba  │ $3,500,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 25  │ 440 E 62nd St Unit 6C, New York, NY 10065                   │ 2bd/1ba    │ $899,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 26  │ 161 E 79th St Unit 7A, New York, NY 10075                   │ 3bd/2.5ba  │ $4,250,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 27  │ 88 Greenwich St #516, New York, NY 10006                    │ 1bd/1ba    │ $750,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 28  │ 123-10 25th Rd, Flushing, NY 11354 (Queens)                 │ 6bd/1.5ba  │ $799,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 29  │ 34-49 73rd St, Jackson Heights, NY 11372 (Queens)           │ 5bd/3ba    │ $1,549,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 30  │ 440 E 57th St Unit 15B, New York, NY 10022                  │ 2bd/2ba    │ $1,349,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 31  │ 207 W 79th St Unit 5A, New York, NY 10024                   │ 4bd/3.5ba  │ $5,995,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 32  │ 350 Albany St Unit 2K, New York, NY 10280                   │ 1bd/1ba    │ $595,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 33  │ 2505 Broadway Unit 7B, New York, NY 10025                   │ 2bd/2ba    │ $2,195,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 34  │ 444 E 86th St Unit 17F, New York, NY 10028                  │ 4bd/4.5ba  │ $3,250,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 35  │ 69 El Camino Loop, Staten Island, NY 10309                  │ 4bd/3.5ba  │ $899,999   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 36  │ 215 Beach 96th St, Rockaway Beach, NY 11693 (Queens)        │ 8bd/6ba    │ $1,299,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 37  │ 70 E 10th St Unit 2A, New York, NY 10003                    │ 2bd/2ba    │ $1,968,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 38  │ 26-26 Jackson Ave #802, Long Island City, NY 11101 (Queens) │ 2bd/2ba    │ $1,450,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 39  │ 707 Hollywood Ave, Bronx, NY 10465                          │ 5bd/3ba    │ $999,000   │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 40  │ 333 14th St Unit 2F, Brooklyn, NY 11215                     │ 3bd/2.5ba  │ $1,995,000 │
  ├─────┼─────────────────────────────────────────────────────────────┼────────────┼────────────┤
  │ 41  │ 45 Tudor City Pl #1504, New York, NY 10017                  │ 1bd/1ba    │ $599,000   │
  └─────┴─────────────────────────────────────────────────────────────┴────────────┴────────────┘
```

</details>
