# Yelp API 与 Tripadvisor API：按关键词找本地商家

说清一类生意和一个地点，就能拿回结构化的商户列表：名称、评分、评论数、地址和类目。两个数据源都在同一份目录里，每次调用 0.11 积分/成功 起，不需要先被 Yelp 或 Tripadvisor 的开发者计划接纳。它们覆盖的是不同的商户，而不是同一份数据的两个副本，所以不把两者排成高低。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「用鹦鹉AI 在 Yelp 和 Tripadvisor 上找德克萨斯州奥斯汀的拉面店。先告诉我价格，再给我一份合并列表，每家包含名称、评分、评论数和地址。」

- **把「找什么」和「在哪」分开给** 两个源都把描述和地点作为两个独立字段。揉成一整段文字，解析效果很差。
- **城市和州都写上** 这项任务最常见的空结果，就是两个源都不认识那个地点字符串。
- **说明要哪个源** Yelp 和 Tripadvisor 收录的商家不同。两个都要，就并排拿回两份结果。
- **先问价格** 鹦鹉AI 在调用前返回费用，agent 可以先说明这次要花多少。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `litescrape.yelp.business.search` — 搜索 Yelp 商家 (yelp): https://parrot.amorist.cn/catalog/yelp
- `serpapi.x.yelp-search` — 按描述和位置搜索 Yelp 商家 (yelp): https://parrot.amorist.cn/catalog/yelp
- `dataforseo.x.business-data-tripadvisor-search-task-post` — 搜索 Tripadvisor 商户主页（异步任务） (tripadvisor): https://parrot.amorist.cn/catalog/tripadvisor

## 大家实际卡在哪

取自 2026 年 8 月读过的约 200 篇 Reddit 与 X 帖子，剔除 11 条推广内容，其中包括 3 个账号用「家里人的小生意」这同一套说辞，把同一个 Google Maps 爬虫铺到三个 subreddit。引用之前先说一条结论：自然内容里没有人说 Yelp 关掉了 API 计划，所以这一页也不这么说。人们实际抱怨的痛点不一样，也更日常。

**在 Postman 里能用，进了应用就死**

> "我在 postman 里调用是成功的，但从应用本地发起调用时就遇到这个错误" (r/Angular2, 2 points: https://www.reddit.com/r/Angular2/comments/7ns9gv/experiencing_403_when_making_get_call_to_yelp_api/)

这一页能帮上的： 这个形态在调研里出现了六次，也是这一页能诚实认领的一个主题。密钥没问题，请求也没问题；错的是调用从哪里发出，通常是浏览器的预检请求，或者一把最后被塞进前端打包产物里的密钥。通过 鹦鹉AI 的调用从一台服务器出去，凭据在那里注入，所以这一类失败就不存在了。但它救不了被数据源拒绝的参数。

**一千条结果是天花板，任何代理都抬不高它**

> "别指望能拉到超过 1,000 条结果，Yelp Fusion API 在这方面有硬性限制" (r/learnpython, 7 points: https://www.reddit.com/r/learnpython/comments/92hcf7/how_to_loop_api_call_requests_yelp_fusion/)

这一页能帮上的： 没有好答案，暗示有才是不诚实。数据源的上限是数据源的属性；从别人那里买这次调用并不会把它抬高。真正管用的只有把问题摊开：把一个大都市区拆成各个郊区，把一个行业拆成各类目，每一片按次付费。这是你的 agent 能跑的循环，也正是为什么按次价格比看起来更要紧。

**没人会去读内容权利条款，直到有事逼他们读**

> "我读到内容权利那一段时才发现，自己之前根本没查过那些信息我到底需要什么权利。" (r/webdev, 3 points: https://www.reddit.com/r/webdev/comments/1jekz4a/yelp_fusion_api_as_third_party_info_rights/)

这一页能帮上的： 同样没有好答案，而这也正是这样的页面最想含糊过去的地方。替你注入凭据改变的是谁持有密钥。它没有改变谁受数据源条款约束——那仍然是你；你在这里拉下来的一条商家信息，仍然是 Yelp 或 Tripadvisor 的内容。如果打算转载，那是它们条款的问题，不是价格表的问题。

**Tripadvisor 不让你在 localhost 上开发**

> "但问题是 Tripadvisor 的 API 不允许填 localhost:3000。" (r/node, 5 points: https://www.reddit.com/r/node/comments/14hvtrp/how_do_i_allow_localhost3000_whem_i_am_using/)

这一页能帮上的： 一个小而真实的胜利。Tripadvisor 自己的计划发的是绑定域名的密钥，而笔记本恰恰没有域名，底下那串回复就是人们在给它发明各种绕法。这里的这一行根本不用那把密钥，所以没有任何东西需要限制，也不需要先注册什么才能在你自己的机器上试。

**大多数人早就转去 Google Maps 了，而它到前台就停住**

> "我遇到的问题在于，大多数工具（Google Maps 等）只给我公开的前台电话。" (r/ClaudeCowork, 8 points: https://www.reddit.com/r/ClaudeCowork/comments/1uxezdz/what_are_you_using_to_scrape_local_business/)

这一页能帮上的： 这是整个调研里声音最大的主题，所以它值得一个直接的答案，而不是绕开。如果你想要的数据源是 Google Maps，那这一页不是：鹦鹉AI 今天的菜单上没有 Places 关键词搜索，它现有的与本地相关的 Google 行，针对的是你自己已经拥有的商家资料。至于后半句，任何商家信息源都不带老板的地址，因为那条商家信息里本来就没有。越过前台是第二步，要打到商家自己的网站上去，而这一步有一条硬底线。

## 真正不一样的地方

- 两个工具的机制不同，其中一个不是一次往返。SerpApi 用描述和地点去读 Yelp 自己的结果页，立即返回。DataForSEO 对 Tripadvisor 提交异步任务，之后再取结果，所以这一侧是两次调用、中间要等。要让 agent 预期到这个节奏，而不是把第一次的空响应当成失败。
- 这项任务出问题最安静的地方就是地点。DataForSEO 接受地点名或数字地点代码，代码不是你要的那个，它照样会为错误的市场返回一份完全有效的结果。SerpApi 接受自由文本，宽松是宽松，直到两个地方同名。城市和州都给上，并且在跑三百条查询之前先核对第一条结果的地址。
- 两个工具都不会让你成为 Yelp 或 Tripadvisor 的开发者，也都不改变内容归谁。没有要审批的 Fusion 密钥，也没有要注册的、绑定域名的 Tripadvisor 密钥——调研里卡住很多人的那一步因此消失了。不变的是授权：商户数据属于 Yelp 和 Tripadvisor，谁转载就受谁的条款约束，代注入凭据也一样。

## 本地商家搜索会返回什么？

某个地点、某一类生意的一页商户列表，以数据结构化返回：名称、评分以及评分基于多少条评论、地址、源给它归的类目，以及它在该源上的页面。这是目录查询，不是销售线索名单。结果不会打分、不会跨源去重、也不会拿公司注册库来核对；两个源收录的目录不同，对「有哪些商家」本来就会给出不一致的答案。

## 开始之前

**一次本地商家搜索要多少钱？** 按工具自己的费率，从预付余额扣，不绑套餐。两个源分开定价，不能合成一个统一数字。

**这就是 Yelp Fusion API 吗？** 不是。Yelp 那个工具是拿描述和地点去读 Yelp 的公开结果页，所以没有 Fusion 密钥、不用申请、也不用等审批。这也意味着你拿到的是结果页显示的内容，而不是 Fusion 的字段集；而且你能拿这些商户数据做什么，仍然受 Yelp 条款约束。

**能用这种方式搜 Google Maps 或 Google Business Profile 吗？** 在这一页不行。鹦鹉AI 的目录里目前没有 Google Places 关键词搜索；它确实有的本地类 Google 工具，读的是你自己拥有、且已连接的账号下的商家资料。如果你需要的是 Maps 这个源，这项任务给不了；直说比给个差不多的答案更有用。

**能拿到老板的邮箱吗？** 不能，任何目录类数据源都不能。目录条目带的是商家的公开联系方式，实际上就是前台。要走得更远，就得逐个访问商家自己的网站并核验找到的东西——那是另一项任务，有它自己的失败率，不是在这里点一个字段就能拿到的。

HTML 版本： https://parrot.amorist.cn/use-cases/find-local-businesses-by-keyword-and-location