> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# SEO指南

> 在同一市场比较关键词需求，找出该主题的排名页面，交给编辑一张带来源的内容决策表。

规划 SEO 内容专题时，先用 `POST /v1/seo/keyword-overview` 在同一市场比较关键词需求，再用 `POST /v1/seo/ranked-keywords` 找出该主题目前有排名的页面，最后交给编辑一张「关键词、排名页、内容动作」对应的表。下面以咖啡机维护专题为例。

## 1. 比一批选题词

向 `POST https://api.beatapi.io/v1/seo/keyword-overview` 发 JSON，使用 BeatAPI Bearer 鉴权。

```json
{"keywords":["descale coffee machine","clean coffee grinder"],"country":"us","language":"en"}
```

对照 `results` 里每个词的搜索量、意图和难度。每个词写一句判断，例如「除垢步骤适合做操作教程」。搜索量缺失时留空；如果客服已有相关的用户原句，把原句作为另一条立题依据。

## 2. 看同行在哪些页面回答这个问题

向 `POST /v1/seo/ranked-keywords` 发送下面的请求体：

```json
{"domain":"example.com","contains":"descale","country":"us","language":"en","limit":5}
```

保存命中的词、排名页、`position` 和 `position_seen_at`。打开入选页面，查看每个页面讲了哪些机型和使用条件。要看某个页面被哪些网站引用，先用 `POST /v1/seo/backlinks` 查该域名，再在结果里按目标页面筛选。记下每批实际取回的范围。

## 3. 给编辑一张可以决定做什么的表

每行写关键词、市场、观察时间、相关排名页和要补的角度。例如同行页面已经写了通用除垢步骤，就提出「另外补硬水地区的除垢频率建议」，并标明还需核对设备手册。记录每次请求的 `billed_rows` 与 `usage.price_usd`，单价见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

[SEO API 字段与计费](/zh/seo) · [SEO 问题解答](/zh/faq/seo)