使用场景

对照 Airbnb 同类房源，为你的短租房源定价

Q: 最小的一次运行是多少？

limitPerUrl 最小为 10，所以每个链接至少返回 10 个房源。

Q: 一次运行能读取多个区域吗？

可以。在 urls 中传入多个搜索链接即可；limitPerUrl 限制从每个链接取多少房源。

按地点和日期拉取 Airbnb 房源，含整段住宿价和每晚价、评分、评论数、房东与设施，用来为你自己的短租房源制定价格。

预付费，无订阅REST 或 MCP一个密钥搞定模型、数据和智能体

在不知道同类房源同一时段卖多少钱的情况下定每晚房价，只能靠猜，而猜出来的价格不是白白少赚，就是让房间空着。可比房源就在 Airbnb 上，但一次只能看一页搜索结果。Lovely Router 替你读取它们。发送带日期的搜索链接，每个房源返回一个 JSON 对象，按房源数从预付费余额中计费。用一个 API 密钥，就能从脚本、定价表格或 AI 智能体中调用。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。

对照 Airbnb 同类房源，为你的短租房源定价. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>

工作原理

生成搜索链接
在 Airbnb 上搜索目标街区，填入入住日期、退房日期和入住人数，然后复制链接。
设置上限后运行工具
把链接发送到 POST /v1/tools/airbnb-listings/run，在输入中带上 limitPerUrl，在请求上带上 max_results。运行会从你的余额中预留它的最高费用，并以 JSON 返回房源。
制定你的价格
把每晚价格与评分、评论数和设施放在一起比较，找出与你的房源最接近的可比房源，确定你的定位。

一次请求获取你所选日期的可比房源

搜索 Airbnb 房源在 urls 中接受搜索链接，日期包含在链接里。limitPerUrl 限制每个链接返回的房源数量，每次运行从 10 个到 100 个不等：

Shell

curl https://lovelyrouter.com/v1/tools/airbnb-listings/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "urls": [
          "https://www.airbnb.com/s/Lisbon/homes?checkin=2026-11-09&checkout=2026-11-14&adults=2"
        ],
        "limitPerUrl": 10
      },
    "max_results": 10
  }'

也可以用地名代替链接。运行超过 60 秒仍未结束时会返回 202；轮询方法见运行工具。

每个房源包含什么

字段组	你得到的内容
价格	整段住宿的价格和每晚价格
质量	评分和评论数
房东	房源的房东
服务内容	设施和房屋守则
内容	照片

价格取决于搜索链接中的日期，因此改变日期，就能看到工作日、周末和大型活动期间的价格。

实用配方

周末与工作日定价对比。

对同一街区分别查询周五到周日和周一到周三的住宿，比较每晚价格的中位数。

大型活动周的价格。

分别查询你所在城市的会议或节庆周与普通周，看看可比房源涨价了多少。

找出最接近的可比房源。

保留评分和评论数相近的房源，再看价格最高的那些房源有哪些设施是你的房子没有的。

面向房东的每周价格报告。

如果你管理多处房产，可为每个街区安排定时运行，并把可比房源的价格区间连同你的建议价发给房东。

读懂房屋守则。

让模型汇总所有结果里的房屋守则和设施，看看在你所在的价格档位上，住客能接受哪些规则。

更想直接用自然语言提问？连接 MCP 服务器，然后对 Claude Code 或 Cursor 说："拉取 Lisbon 在 2026-11-09 到 2026-11-14、2 位住客的 30 个 Airbnb 房源。告诉我每晚价格的中位数，以及评分最高的五个房源和它们的设施。把 max_results 设为 30。"