本地 SEO 工作流
利用 YepAPI 端点，通过 Google Maps 和本地 SERP 数据进行本地商家研究。
使用的端点
| 端点 | 费用 | 用途 |
|---|---|---|
POST /v1/serp/google/maps | $0.01 | Google Maps / 本地商家结果 |
POST /v1/scrape | $0.01 | 爬取竞争对手网站的 NAP 数据 |
POST /v1/seo/keywords | $0.15 | 本地关键词指标（搜索量、难度） |
POST /v1/seo/page-audit | $0.03 | 检查用户网站的本地 SEO 信号 |
工作流
步骤 1：本地竞争对手发现
运行 POST /v1/serp/google/maps，传入商家类别和位置。
{
"query": "plumber in austin tx",
"location": "us"
}
返回：包含评分、评论数、类别和地址的本地商家列表。
步骤 2：提取 NAP 数据
针对每个竞争对手，在其网站上运行 POST /v1/scrape。
{
"url": "https://competitor-plumber.com",
"format": "markdown"
}
提取 NAP（名称、地址、电话）数据，以比较各列表之间的一致性。
步骤 3：本地关键词研究
运行 POST /v1/seo/keywords，传入本地关键词。
{
"keywords": ["plumber in austin", "emergency plumber austin tx", "austin plumbing service"],
"location": "us"
}
返回：本地搜索量、CPC、难度——本地关键词搜索量较低但用户意图更强。
步骤 4：页面审计
在用户网站上运行 POST /v1/seo/page-audit。
{
"url": "https://example-plumber.com"
}
检查本地 SEO 信号：结构化数据（LocalBusiness schema）、NAP 一致性、元标签中的位置关键词。
步骤 5：呈现发现结果
- 本地竞争对手格局（评分、评论数、排名）
- 关键词机会（具有搜索量和难度的本地术语）
- 页面修复（缺少结构化数据、NAP 不一致、元标签缺口）
规则
- 始终在 Maps 查询中包含位置——结果依赖于位置
- NAP 一致性对本地 SEO 至关重要——标记出不一致的情况
- Google Maps 结果包含评分、评论数和类别——用于竞争对手基准测试
- 本地关键词搜索量较低但用户意图更强——优先考虑转化潜力
错误处理
NO_CREDITS(402) — 告知用户在 https://yepapi.com/dashboard 添加积分UPSTREAM_ERROR(502) — 重试一次；如果再次失败，跳过该步骤并记录VALIDATION_ERROR(400) — 检查查询格式；在查询字符串中包含位置RATE_LIMITED(429) — 等待后重试；遵循Retry-After头部信息