# Etsy Search by Keyword Scraper MCP Server | Scrapier (https://scrapier.io/scrapers/etsy/search/mcp/)

> Scrapier's Etsy Search by Keyword Scraper MCP server gives Claude, Cursor and any MCP client Etsy results as JSON. One command. 1 credit per page. Free tier.

Last updated: 2026-11-12

**GET**/api/v2/etsy-search-by-keyword/

## Etsy Search by Keyword Scraper _MCP Server_

Give Claude, Cursor and ChatGPT a tool for any public Etsy page of listings. One command connects it; every call returns typed JSON. 1 credit per page of listings.

[Get a free API key →](https://app.scrapier.io/sign-up) [Jump to setup](#setup)

Free API key · 1 credit per page of listings · failed calls free

Last updated 9 Nov 2026

Live agent run

Copy for your AI agent

Install

## Connect in one command

Quick answerScrapier's MCP server gives **Claude, Cursor and any MCP client** tools for public Etsy pages of listings, returned as JSON. One command connects it. Each call costs 1 credit.

terminal

claude mcp add -t http scrapier \\
  https://mcp.scrapier.io/mcp \\
  --header "X-API-Key: YOUR\_API\_KEY"

Then ask: _"Get the Etsy page of listings for handmade necklace"_

Connect

## Custom connector

Connect any client that supports remote MCP with one URL and your API key.

### Custom connector

Any MCP client

Paste one URL into any client that supports remote MCP and send your Scrapier API key in an `X-API-Key` header.

`https://mcp.scrapier.io/mcp`

Where to paste it

- **Claude**Settings → Connectors → Add
- **ChatGPT**Settings → Apps → Developer mode → Create
- **Cursor**Settings → MCP → Add new server

[Step-by-step setup ↓](#setup)

Setup

## Setup in Claude, Cursor, Windsurf and ChatGPT

Pick your client. Three steps, under a minute.

1. Get a free API key from your Scrapier dashboard.
2. Run the command below in your terminal.
3. Restart Claude Code and run `/mcp` to see the tools.

terminal

claude mcp add -t http scrapier https://mcp.scrapier.io/mcp --header "X-API-Key: YOUR\_API\_KEY"

claude · ~/project

**›** /mcp

Manage MCP servers

● scrapier · connected · 6 tools

└ search\_endpoints

└ run\_scrape

└ …4 more

**›**

### Verify the connection

Ask **"List your Etsy tools"**. The agent should find `run_scrape` and `search_endpoints`.

Tools

## Etsy MCP Tools

Use `search_endpoints` to discover, `run_scrape` to call.

| Tool | Returns | Inputs | Key fields | Credits |
| --- | --- | --- | --- | --- |
| `run_scrape` | Run the page of listings scraper | `endpoint="etsy-search-by-keyword", queries="..."` | listing\_id, listing\_url, title, image\_url, price | 1 |

### Output fields

run\_scrape · 200 OK

{
  "success": true,
  "data": {
    "query": "handmade necklace",
    "page": 1,
    "etsy\_page": 1,
    "total\_pages": 20,
    "page\_size": 34,
    "listings": \[
      {
        "listing\_id": "1772679468",
        "listing\_url": "https://www.etsy.com/listing/1772679468/handmade-sterling-silver-byzantine-chain",
        "title": "Handmade Sterling Silver Byzantine Chain Necklace - Bali Silver",
        "image\_url": "https://i.etsystatic.com/52961888/r/il/881c8e/6192875617/il\_fullxfull.6192875617\_g6jb.jpg",
        "price": 105.04,
        "currency": "USD",
        "rating": 4.7,
        "review\_count": 927,
        "shop\_name": "SilverChainArts",
        "shop\_url": "https://www.etsy.com/shop/SilverChainArts",
        "is\_on\_sale": true,
        "has\_free\_shipping": true,
        "badges": \[\],
        "data\_source": "etsySearchApi",
        "search\_query": "handmade necklace",
        "search\_url": "https://www.etsy.com/search?q=handmade+necklace",
        "page": 1,
        "position": 1,
        "scraped\_at": "2026-09-26T11:00:24.260Z"
      }
    \],
    "next\_cursor": "eyJuIjozNCwibnAiOjIsInAiOjIsInEiOiJoYW5kbWFkZSBuZWNrbGFjZSIsInMiOiJ0YmVvOGMua3huM2ZwLjIzYnhwamguMjM3Y21rMC4yMDRzNDU5LjIzYnpqMmwucmR5ODdzLjIycXU1YTAudGEzcmVoLjIzbWJvMmEuMjE4cjhuYi4yMnowMmVzLjIzcWQ0ZzcuMjJ1NXN4MS4yMXB3bmF6LjIyejJldHQuMjNsaTd4ci4yM29wZDl2LjIwMWFuM2oucXNkaXJ0LjIxMDNtMGkua29haGRxLjIzZDMzMmUucGl2aXI0LjIzZzdsdXMuZ2FldWdjLjIzOXpwYnMuMjJkcnZkNC5vMHJ1NGUucnJuN3J3LjIwNDJ1MGIuMjNtMzQxbC4yM2p2d2w1LjIyM282b2UiLCJ0cCI6MjB9"
  }
}

Examples

## Example Prompts and Tool Calls

The prompt, the tool call, the JSON and the answer.

### Get page of listings data

Get the page of listings data for handmade necklace.

### ⚙ run\_scrape(endpoint="etsy-search-by-keyword", queries="handmade necklace")

run\_scrape(endpoint="etsy-search-by-keyword", queries="handmade necklace")

{
  "listing\_id": "1772679468",
  "listing\_url": "https://www.etsy.com/listing/1772679468/handmade-sterling-silver-byzantine-chain",
  "title": "Handmade Sterling Silver Byzantine Chain Necklace - Bali Silver",
  "image\_url": "https://i.etsystatic.com/52961888/r/il/881c8e/6192875617/il\_fullxfull.6192875617\_g6jb.jpg"
}

Here are the page of listings details from the Scrapier API.

Workflows

## Agent Workflows

### Etsy data pipeline

1. input list
2. run\_scrape
3. filter results
4. export

Feed a list, pull each page of listings, filter by criteria, export the result.

Compare

## Etsy Scraper MCP vs the Official Etsy MCP

|  | Scrapier Etsy MCPThis page | Official Etsy API | Apify actor over MCP |
| --- | --- | --- | --- |
| Data returned | Any public page of listings, typed JSON | Your own accounts and insights | Varies by actor |
| Auth needed | One Scrapier key | Etsy app + business account | Apify token |
| Cost model | 1 credit per call | Free once approved | Compute units per run |
| Rate limits | 3 parallel per key | Per-user hourly quota | Per actor |
| Best for | Research, enrichment, monitoring | Own-account analytics | Custom one-off crawls |

### Limits

- Public data only — private pages of listings return identity fields only
- Counts are live at call time; no history unless you store it

Billing

## Credits, Rate Limits and Security

Credits per call**1**

Parallel requests**3 per key**

Auth**One Scrapier key, no Etsy login**

- Your key stays in your client config, never in prompts
- No Etsy account or cookies are used
- Failed calls cost 0 credits
- Rotate or revoke keys any time from the dashboard

[See full pricing →](https://scrapier.io/pricing/)

Troubleshooting

## Troubleshooting

### Tools not showing

Restart the client after editing its config. In Claude Code run /mcp; in Cursor check the server toggle is on.

### 401 invalid key

The key is missing or mistyped. Copy it again from the dashboard.

### 429 rate limit

You exceeded your plan's parallel requests. The agent should wait for Retry-After.

### Timeout on large requests

Batch in smaller groups, or raise the client timeout to 210 seconds.

FAQ

## Frequently Asked Questions

### Is there a Etsy scraper MCP server?

Yes. Scrapier's MCP server exposes Etsy page of listings tools to Claude, Cursor, Windsurf and ChatGPT. One command connects it and every call returns typed JSON.

### How do I scrape Etsy pages of listings with Claude?

Run \<code>claude mcp add -t http scrapier https://mcp.scrapier.io/mcp\</code> with your API key, then ask Claude for any public page of listings. It calls \<code>run\_scrape\</code> and reads the JSON directly.

### Does it need a Etsy login?

No. The server reads public data only and uses no Etsy account or cookies.

### How much does a Etsy MCP call cost?

1 credit per call — about $1.58 per 1,000 pages of listings on the Pro plan. Failed calls are free.

### Can ChatGPT use the Etsy scraper?

Yes. Add Scrapier as a custom connector in ChatGPT's developer mode and the same tools appear in chat.

More servers

## Related MCP Servers

[### Product Info by Url MCP

product →](https://scrapier.io/scrapers/etsy/product/mcp/)[### Product Reviews MCP

reviews →](https://scrapier.io/scrapers/etsy/reviews/mcp/)[### Search Suggestions MCP

search-suggestions →](https://scrapier.io/scrapers/etsy/search-suggestions/mcp/)[### All Etsy scrapers

6 endpoints →](https://scrapier.io/scrapers/etsy/)

## Give your agent Etsy data

1 tool · JSON · one key

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

---
Canonical page: https://scrapier.io/scrapers/etsy/search/mcp/
Site index for AI agents: https://scrapier.io/llms.txt
