semrush-research

SemRush 研究

从 SemRush API 获取实时 SEO 和竞争情报数据。

先决条件

需要在 .env、.env.local 或 ~/.claude/.env.global 中设置 SEMRUSH_API_KEY。

# Verify the key is available
echo "SEMRUSH_API_KEY is ${SEMRUSH_API_KEY:+set}"

如果未设置密钥，请告知用户：

你需要一个 SemRush API 密钥。请前往 https://www.semrush.com/api/ 获取。 然后将 SEMRUSH_API_KEY=your_key 添加到你的 .env 文件中。

API 基础地址

所有请求均发送到 https://api.semrush.com/，并通过 &key={SEMRUSH_API_KEY} 传递 API 密钥。

响应为以分号分隔的 CSV。第一行为标题行。请据此进行解析。

---

1. 域名概览

获取任意域名自然搜索和付费搜索表现的高级概览。

端点

https://api.semrush.com/?type=domain_ranks&key={KEY}&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain={domain}

导出列

列	含义
Dn	域名
Rk	SemRush 排名
Or	自然搜索关键词数量
Ot	自然搜索流量估算值
Oc	自然搜索流量成本（美元）
Ad	付费关键词数量
At	付费流量估算值
Ac	付费流量成本（美元）

curl 示例

curl -s "https://api.semrush.com/?type=domain_ranks&key=${SEMRUSH_API_KEY}&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=example.com"

解析响应

# Response format (semicolon-delimited):
# Dn;Rk;Or;Ot;Oc;Ad;At;Ac
# example.com;12345;8234;145000;234500;120;3400;5600

# Parse with awk
curl -s "..." | awk -F';' 'NR==2 {
  printf "Domain: %s\nSemRush Rank: %s\nOrganic Keywords: %s\nOrganic Traffic: %s\nOrganic Traffic Cost: $%s\nPaid Keywords: %s\nPaid Traffic: %s\nPaid Traffic Cost: $%s\n",
  $1,$2,$3,$4,$5,$6,$7,$8
}'

---

2. 关键词概览

获取关键词的搜索量、CPC、竞争程度和 SERP 功能。

端点

https://api.semrush.com/?type=phrase_all&key={KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td

导出列

列	含义
Ph	关键词短语
Nq	搜索量（月）
Cp	CPC（美元）
Co	竞争程度（0-1）
Nr	结果数量
Td	趋势（12 个月，以逗号分隔）

curl 示例

curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase=content+marketing&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"

支持的数据库

使用 &database=XX，其中 XX 为：us、uk、ca、au、de、fr、es、it、br、in、jp。

---

3. 相关关键词

查找语义相关的关键词，用于内容规划和差距分析。

端点

https://api.semrush.com/?type=phrase_related&key={KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td&display_limit=20

curl 示例

curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase=project+management&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td&display_limit=20"

解析多行数据

curl -s "..." | awk -F';' 'NR>1 { printf "%-40s Vol: %-8s CPC: $%-6s Comp: %s\n", $1, $2, $3, $4 }'

---

4. 关键词难度

估算关键词的排名难度。

端点

https://api.semrush.com/?type=phrase_kdi&key={KEY}&phrase={keyword}&database=us&export_columns=Ph,Kd

列	含义
Ph	关键词
Kd	关键词难度（0-100）

解读：

• 0-29：简单——凭借优质内容即可实现
• 30-49：中等——需要扎实的内容和一些反向链接
• 50-69：困难——需要较强的域名权威度和反向链接
• 70-84：非常困难——需要已有的权威度
• 85-100：极其困难——由顶级域名主导

---

5. 域名自然搜索关键词

查看某个域名在自然搜索中获得排名的关键词。

端点

https://api.semrush.com/?type=domain_organic&key={KEY}&domain={domain}&database=us&export_columns=Ph,Po,Nq,Cp,Url,Tr,Tc&display_limit=50&display_sort=tr_desc

列	含义
Ph	关键词
Po	排名位置
Nq	搜索量
Cp	CPC
Url	排名 URL
Tr	流量（%）
Tc	流量成本

curl 示例

curl -s "https://api.semrush.com/?type=domain_organic&key=${SEMRUSH_API_KEY}&domain=hubspot.com&database=us&export_columns=Ph,Po,Nq,Cp,Url,Tr,Tc&display_limit=20&display_sort=tr_desc"

---

6. 反向链接概览

获取域名反向链接配置文件的摘要。

端点

https://api.semrush.com/analytics/v1/?key={KEY}&type=backlinks_overview&target={domain}&target_type=root_domain&export_columns=total,domains_num,urls_num,ips_num,follows_num,nofollows_num,texts_num,images_num

curl 示例

curl -s "https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=backlinks_overview&target=example.com&target_type=root_domain&export_columns=total,domains_num,urls_num,ips_num,follows_num,nofollows_num,texts_num,images_num"

---

7. 竞争对手发现

查找在相同自然搜索关键词上竞争的域名。

端点

https://api.semrush.com/?type=domain_organic_organic&key={KEY}&domain={domain}&database=us&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&display_limit=10

列	含义
Dn	竞争对手域名
Cr	竞争程度
Np	共同关键词
Or	自然搜索关键词
Ot	自然搜索流量
Oc	自然搜索流量成本
Ad	付费关键词

curl 示例

curl -s "https://api.semrush.com/?type=domain_organic_organic&key=${SEMRUSH_API_KEY}&domain=notion.so&database=us&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&display_limit=10"

---

8. 流量分析（估算值）

估算域名的整体流量来源和互动情况。

端点

https://api.semrush.com/analytics/ta/api/v3/summary?key={KEY}&targets={domain}&display_date=2024-01-01&country=us&export_columns=target,visits,users,bounce_rate,pages_per_visit,avg_visit_duration

---

工作流：完整竞争分析

当用户要求进行完整竞争分析时，请按以下顺序执行：

1. 域名概览 - 获取目标域名的指标
2. 竞争对手发现 - 查找前 5-10 个竞争对手
3. 对每个竞争对手进行域名概览 - 比较指标
4. 查找每个域名的热门关键词 - 找出关键词差距
5. 获取每个域名的反向链接概览 - 比较链接配置文件

输出格式

将结果以对比表格的形式呈现：

| Metric              | target.com | competitor1.com | competitor2.com |
|---------------------|-----------|-----------------|-----------------|
| SemRush Rank        | ...       | ...             | ...             |
| Organic Keywords    | ...       | ...             | ...             |
| Organic Traffic     | ...       | ...             | ...             |
| Traffic Cost        | ...       | ...             | ...             |
| Backlinks           | ...       | ...             | ...             |
| Referring Domains   | ...       | ...             | ...             |

然后重点指出：

• 关键词差距：竞争对手有排名、目标网站却没有排名的关键词
• 快速提升机会：目标网站排名在第 5–20 位的关键词（可提升的机会）
• 内容差距：竞争对手涵盖、目标网站却未涵盖的主题
• 反向链接机会：链接到竞争对手、但未链接到目标网站的站点

速率限制和费用

• 每次 API 调用都会消耗 API 单位（请查看你的套餐）
• 使用 &display_limit= 控制结果数量（默认值因端点而异）
• 执行多步分析时，在本地缓存结果，避免重复调用
• 域名概览调用的费用最低；反向链接和流量分析的费用更高

错误处理

错误	含义
ERROR 50 :: NOTHING FOUND	此查询没有数据
ERROR 120 :: WRONG KEY	API 密钥无效
ERROR 130 :: LIMIT EXCEEDED	已达到 API 单位上限
空响应	通常表示没有符合查询参数的数据

遇到“NOTHING FOUND”时，请尝试：

• 更换数据库（例如，使用 uk 而不是 us）
• 使用根域名，而不是子域名
• 使用更宽泛的关键词短语