New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →
GET/api/v2/airbnb-occupancy/

Airbnb Occupancy Scraper MCP Server

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

Free API key · 1 credit per month of calendar · failed calls free

Last updated
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 Airbnb months of calendar, 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 Airbnb month of calendar for 569049214818933247"
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
  • ClaudeSettings → Connectors → Add
  • ChatGPTSettings → Apps → Developer mode → Create
  • CursorSettings → MCP → Add new server
Step-by-step 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 Airbnb tools". The agent should find run_scrape and search_endpoints.

Tools

Airbnb MCP Tools

Use search_endpoints to discover, run_scrape to call.

ToolReturnsInputsKey fieldsCredits
run_scrapeRun the month of calendar scraperendpoint="airbnb-occupancy", room_id="..."room_id, url, date, available1

Output fields

run_scrape · 200 OK
{
  "success": true,
  "data": {
    "room_id": "569049214818933247",
    "url": "https://www.airbnb.com/rooms/569049214818933247",
    "month": 12,
    "year": 2026,
    "page_size": 31,
    "days": [
      {
        "room_id": "569049214818933247",
        "url": "https://www.airbnb.com/rooms/569049214818933247",
        "date": "2026-12-01",
        "available": true
      },
      {
        "room_id": "569049214818933247",
        "url": "https://www.airbnb.com/rooms/569049214818933247",
        "date": "2026-12-02",
        "available": false
      }
    ],
    "next_cursor": "eyJoIjoiYWJjMTIzZGVmIiwibSI6MSwicmlkIjoiNTY5MDQ5MjE0ODE4OTMzMjQ3IiwieSI6MjAyN30"
  }
}
Examples

Example Prompts and Tool Calls

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

Get month of calendar data

Get the month of calendar data for 569049214818933247.
⚙ run_scrape(endpoint="airbnb-occupancy", room_id="569049214818933247")
run_scrape(endpoint="airbnb-occupancy", room_id="569049214818933247")
{
  "room_id": "569049214818933247",
  "url": "https://www.airbnb.com/rooms/569049214818933247",
  "date": "2026-12-01",
  "available": true
}
Here are the month of calendar details from the Scrapier API.
Workflows

Agent Workflows

Airbnb data pipeline

  1. input list
  2. run_scrape
  3. filter results
  4. export

Feed a list, pull each month of calendar, filter by criteria, export the result.

Compare

Airbnb Scraper MCP vs the Official Airbnb MCP

Scrapier Airbnb MCPThis pageOfficial Airbnb APIApify actor over MCP
Data returnedAny public month of calendar, typed JSONYour own accounts and insightsVaries by actor
Auth neededOne Scrapier keyAirbnb app + business accountApify token
Cost model1 credit per callFree once approvedCompute units per run
Rate limits3 parallel per keyPer-user hourly quotaPer actor
Best forResearch, enrichment, monitoringOwn-account analyticsCustom one-off crawls

Limits

  • Public data only — private months of calendar return identity fields only
  • Counts are live at call time; no history unless you store it
Billing

Credits, Rate Limits and Security

Credits per call1
Parallel requests3 per key
AuthOne Scrapier key, no Airbnb login
  • Your key stays in your client config, never in prompts
  • No Airbnb account or cookies are used
  • Failed calls cost 0 credits
  • Rotate or revoke keys any time from the dashboard

See full 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 Airbnb scraper MCP server?

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

How do I scrape Airbnb months of calendar 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 month of calendar. It calls <code>run_scrape</code> and reads the JSON directly.

Does it need a Airbnb login?

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

How much does a Airbnb MCP call cost?

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

Can ChatGPT use the Airbnb scraper?

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

Give your agent Airbnb data

1 tool · JSON · one key