agentsclimarketplace
Sign in

Airbnb availability

Skill stayingapi/airbnb-skills/skills/airbnb-availability

Check day-by-day Airbnb availability (the booking calendar) for a known listing over a date window. Use when a user asks whether a listing on Airbnb is open on specific dates. Powered by StayingAPI.From its SKILL.md

Install
npx -y skills add stayingapi/airbnb-skills --skill airbnb-availability

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT-0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.7 KB, 666 tokens by cl100k_base, as published. Nobody here has run it

Airbnb availability

Check day-by-day availability for a known Airbnb listing — the booking calendar over any date window.

Setup

If $STAYINGAPI_KEY is not set, read references/auth-setup.md and follow it to get and store the key. A stay_test_ sandbox key works for evaluation at zero cost.

When to use this skill

DO use when the user asks:

  • "Is this Airbnb listing free the first week of August?"
  • "Show the calendar for this Airbnb place"

Do NOT use when:

  • You do not yet have a listing id — search first
  • The user wants a price, not open/closed dates — use the prices skill

Required headers

Every request needs:

  • Authorization: Bearer $STAYINGAPI_KEY
  • User-Agent: your agent's name (e.g. ClaudeCode/1.0).

Base URL: https://api.stayingapi.com/v1.

Tools

GET /v1/availability

Get day-by-day availability for a known listing (or a batch of listings) on one platform over a date window. Each day reports whether it is available, its minimum-night requirement, and whether check-in / check-out / booking is allowed.

Key parameters:

  • platform — Single platform (not a fan-out endpoint).
  • listingId — A single listing id on platform.
  • listingIds[] — A batch of listing ids on platform.
  • url — Full listing URL (alternative to an id).
  • startDate — YYYY-MM-DD; not in the past.
  • endDate — After startDate; window ≤ 365 days.

MCP (no key pasted into the agent)

On an MCP-capable runtime, connect https://mcp.stayingapi.com/mcp (OAuth 2.1 + PKCE) and use: check_availability.

The cross-OTA advantage

StayingAPI is cross-platform: Airbnb data comes back in the same unified schema as Airbnb, Booking.com, Vrbo and Google Hotels, and the price-compare tool returns a computed min and median across every OTA — something a single-platform wrapper can't do.

Async & partial failures

A live call that has to scrape returns 202 + a jobId; poll GET /v1/jobs/{jobId} (free) until data.status is completed, then read data.result. On a fan-out, check meta.partial and meta.platformResults[].

Credits

Number-free by design — failed, empty and blocked calls are never billed, and stay_test_ sandbox calls are always free. Current costs: https://stayingapi.com/pricing · full contract: https://api.stayingapi.com/openapi.json.

Trademark

StayingAPI is an independent service and is not affiliated with, endorsed by, or sponsored by Airbnb. Airbnb is a trademark of its respective owner.

Get your free key → https://stayingapi.com/signup · Docs: https://stayingapi.com/docs

What ships with it: 1 file

1.9 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 326,758. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.