# 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
//This config uses ScraperAPI's remote MCP server, no local setup required"
{
  "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="/files/9sqXSVjysFA7Ulsb9L4S" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scraperapi.com/integrations/llm-integrations/mcp-server/claude-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
