SemRush API 集成技能：实时获取 SEO 与竞争情报数据

semrush-research by openclaudia/openclaudia-skills

76 周安装量

341 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/openclaudia/openclaudia-skills --skill semrush-research

数据分析营销 SEO

🇨🇳中文介绍

SemRush Research

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

前提条件

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

# 验证密钥是否可用
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/，API 密钥作为参数传递。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

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

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

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`	每次点击费用
`Url`	排名 URL
`Tr`	流量占比（%）
`Tc`	流量成本

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"

获取域名外链档案的摘要。

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 -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 -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

工作流程：完整的竞争分析

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

域名概览 - 获取目标域名的指标
竞争对手发现 - 查找前 5-10 名竞争对手
域名概览 针对每个竞争对手 - 比较指标
热门关键词 针对每个域名 - 查找关键词差距
外链概览 针对每个域名 - 比较外链档案

将结果呈现为对比表格：

| 指标              | target.com | competitor1.com | competitor2.com |
|---------------------|-----------|-----------------|-----------------|
| SemRush 排名        | ...       | ...             | ...             |
| 自然关键词数量    | ...       | ...             | ...             |
| 自然流量估计值     | ...       | ...             | ...             |
| 流量成本        | ...       | ...             | ...             |
| 外链数量           | ...       | ...             | ...             |
| 引用域名数量   | ...       | ...             | ...             |

然后突出显示：

关键词差距 ：竞争对手排名但目标域名没有的关键词
快速取胜机会 ：目标域名排名在 5-20 位的关键词（改进机会）
内容差距 ：竞争对手覆盖但目标域名未覆盖的主题
外链机会 ：链接到竞争对手但未链接到目标域名的网站

速率限制和成本

每次 API 调用都会消耗 API 单位（请查看您的套餐）
使用 &display_limit= 来控制结果数量（默认值因端点而异）
在进行多步骤分析时，请在本地缓存结果以避免冗余调用
域名概览调用最便宜；外链和流量分析成本更高

错误	含义
`ERROR 50 :: NOTHING FOUND`	此查询无数据
`ERROR 120 :: WRONG KEY`	无效的 API 密钥
`ERROR 130 :: LIMIT EXCEEDED`	达到 API 单位限制
空响应	通常意味着查询参数没有可用数据

当遇到 "NOTHING FOUND" 时，请尝试：

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

🇺🇸English

SemRush Research

Pull live SEO and competitive intelligence data from the SemRush API.

Prerequisites

Requires SEMRUSH_API_KEY set in .env, .env.local, or ~/.claude/.env.global.

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

If the key is not set, instruct the user:

You need a SemRush API key. Get one at https://www.semrush.com/api/ Then add SEMRUSH_API_KEY=your_key to your .env file.

API Base

All requests go to https://api.semrush.com/ with the API key passed as &key={SEMRUSH_API_KEY}.

Responses are semicolon-delimited CSV. The first line is the header row. Parse accordingly.

1. Domain Overview

Get a high-level snapshot of any domain's organic and paid search performance.

Endpoint

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

Export Columns

Column	Meaning
`Dn`	Domain
`Rk`	SemRush Rank
`Or`	Organic keywords count
`Ot`	Organic traffic estimate
`Oc`	Organic traffic cost ($)
`Ad`	Paid keywords count
`At`

Example 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"

Parsing the Response

# 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. Keyword Overview

Get search volume, CPC, competition, and SERP features for a keyword.

Endpoint

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

Export Columns

Column	Meaning
`Ph`	Keyword phrase
`Nq`	Search volume (monthly)
`Cp`	CPC (USD)
`Co`	Competition (0-1)
`Nr`	Number of results
`Td`	Trend (12 months, comma-separated)

Example 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"

Supported Databases

Use &database=XX where XX is: us, uk, ca, au, de, fr, es, it, br, in, jp.

3. Related Keywords

Find semantically related keywords for content planning and gap analysis.

Endpoint

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

Example 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"

Parsing Multiple Rows

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

4. Keyword Difficulty

Estimate how hard it is to rank for a keyword.

Endpoint

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

Column	Meaning
`Ph`	Keyword
`Kd`	Keyword difficulty (0-100)

Interpretation:

0-29: Easy - achievable with quality content
30-49: Moderate - needs solid content + some backlinks
50-69: Hard - needs strong domain authority + backlinks
70-84: Very hard - requires established authority
85-100: Extremely hard - dominated by top-tier domains

5. Domain Organic Keywords

See which keywords a domain ranks for organically.

Endpoint

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

Column	Meaning
`Ph`	Keyword
`Po`	Position
`Nq`	Search volume
`Cp`	CPC
`Url`	Ranking URL
`Tr`	Traffic (%)
`Tc`

Example 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. Backlink Overview

Get a summary of a domain's backlink profile.

Endpoint

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

Example 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. Competitor Discovery

Find domains competing for the same organic keywords.

Endpoint

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

Column	Meaning
`Dn`	Competitor domain
`Cr`	Competition level
`Np`	Common keywords
`Or`	Organic keywords
`Ot`	Organic traffic
`Oc`	Organic traffic cost
`Ad`

Example 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. Traffic Analytics (Estimates)

Estimate a domain's overall traffic sources and engagement.

Endpoint

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

Workflow: Full Competitive Analysis

When the user asks for a full competitive analysis, run these steps in order:

Domain Overview - Get the target domain's metrics
Competitor Discovery - Find top 5-10 competitors
Domain Overview for each competitor - Compare metrics
Top Keywords for each domain - Find keyword gaps
Backlink Overview for each domain - Compare link profiles

Output Format

Present results as a comparison table:

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

Then highlight:

Keyword gaps : Keywords competitors rank for but target does not
Quick wins : Keywords where target ranks positions 5-20 (improvement opportunities)
Content gaps : Topics competitors cover but target does not
Backlink opportunities : Sites linking to competitors but not target

Rate Limits and Costs

Each API call costs API units (check your plan)
Use &display_limit= to control result count (default varies by endpoint)
Cache results locally when doing multi-step analysis to avoid redundant calls
Domain overview calls are cheapest; backlink and traffic analytics cost more

Error Handling

Error	Meaning
`ERROR 50 :: NOTHING FOUND`	No data for this query
`ERROR 120 :: WRONG KEY`	Invalid API key
`ERROR 130 :: LIMIT EXCEEDED`	API unit limit reached
Empty response	Usually means no data available for the query parameters

When you get "NOTHING FOUND", try:

Different database (e.g., uk instead of us)
Root domain instead of subdomain
Broader keyword phrase

Weekly Installs

Repository

openclaudia/ope…a-skills

GitHub Stars

341

First Seen

Feb 14, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode69

gemini-cli67

codex63

claude-code63

github-copilot62

cursor61

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

51,800 周安装

SemRush API 集成技能：实时获取 SEO 与竞争情报数据

🇨🇳中文介绍

SemRush Research

前提条件

API 基础

相关 Skills

1. 域名概览

端点

导出列

示例 curl 命令

解析响应

2. 关键词概览

端点

导出列

示例 curl 命令

支持的数据库

3. 相关关键词

端点

示例 curl 命令

解析多行数据

4. 关键词难度

端点

5. 域名自然关键词

端点

示例 curl 命令

6. 外链概览

端点

示例 curl 命令

7. 竞争对手发现

端点

示例 curl 命令

8. 流量分析（估计值）

端点

工作流程：完整的竞争分析

输出格式

速率限制和成本

错误处理

🇺🇸English

SemRush Research

Prerequisites

API Base

1. Domain Overview

Endpoint

Export Columns

Example curl

Parsing the Response

2. Keyword Overview

Endpoint

Export Columns

Example curl

Supported Databases

3. Related Keywords

Endpoint

Example curl

Parsing Multiple Rows

4. Keyword Difficulty

Endpoint

5. Domain Organic Keywords

Endpoint

Example curl

6. Backlink Overview

Endpoint

Example curl

7. Competitor Discovery

Endpoint

Example curl

8. Traffic Analytics (Estimates)

Endpoint

Workflow: Full Competitive Analysis

Output Format

Rate Limits and Costs

Error Handling

最新 Skills