pp-semrush

Semrush — Printing Press CLI

前置要求：安装 CLI

此技能使用 semrush-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install semrush --cli-only
   

2. 验证：semrush-pp-cli --version
3. 确保所报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、离线等），请改用直接通过 Go 安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/marketing/semrush/cmd/semrush-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿继续执行技能命令。

何时使用此 CLI

如果你需要以相同方式多次查询 Semrush 数据，例如每周变化、关键词差距、反向链接差距、Site Audit 回归，或者需要通过 Agent 调用 Semrush，且不希望重复花费额度获取已拉取的数据，请使用此 CLI。它不适合一次性的临时查询（官方 Semrush UI 更快），也不适用于 Trends API 工作流（这是有意排除在范围之外的）。

独特功能

这些功能在其他任何用于此 API 的工具中都不可用。

会不断累积的本地状态

• drift — 将本周的域名和关键词快照与上周的进行差异对比，查看哪些内容发生了变化，而无需重复花费额度获取已拉取的数据。

  当 Agent 被问到“本周这个域名有什么变化”时，这是唯一一个能从本地存储中回答问题且不消耗 API 额度的命令。

  semrush-pp-cli drift apple.com --since 7d --agent
  

• snapshot — 为任意资源的当前本地存储状态添加标签（例如 monday-baseline），之后可对比任意两个标签，准确查看两者之间的变化。

  Agent 可以据此跨越多周对话推理状态，而无需再次付费获取相同数据。

  semrush-pp-cli snapshot tag monday && semrush-pp-cli snapshot diff monday today --select phrase,position --agent
  

• backlink new — 仅显示在指定时间段内首次发现的引荐域名和反向链接，因此“本周是否有新网站链接到我们”只需一行命令即可回答。

  无需重新拉取并对比两份完整的反向链接报告，Agent 就能回答有关新近变化的问题。

  semrush-pp-cli backlink new apple.com --since 7d --json
  

• tracking drift — 对 Position Tracking 快照应用窗口函数：按地区和设备查看排名变动超过 N 位、跌出第 1 页或进入第 1 页的关键词。

  一个命令即可回答“本月哪些受跟踪的关键词发生了变化”，这是 Position Tracking 电子邮件无法回答的问题。

  semrush-pp-cli tracking drift 12345 --since 30d --min-delta 3 --agent
  

• audit regression — 对比某个项目最新的两份 Site Audit 快照：新增的问题 ID、已解决的问题，以及各严重性级别的数量变化。

  Agent 可以准确告诉你，两次抓取之间技术 SEO 状态在哪些方面出现了退化。

  semrush-pp-cli audit regression 12345 --agent
  

费用透明度

• budget — 每次 API 调用有记录的单位费用都会保存在本地；预算会按天和命令汇总支出，并根据当前余额探测结果估算项目在月底的消耗。

  它能在请求前告诉 Agent“这次请求会花费 N 个单位”，也能在一个月后告诉你“这些单位都花在哪里了”——仅凭上游服务无法回答这两个问题。

  semrush-pp-cli budget --since 30d --group-by command --agent
  

API 无法完成的跨域名联合查询

• keyword gap — 在同一数据库中对两个或更多域名的自然关键词做差集查询，并支持交集和各自独有模式。

  取代每位 SEO 顾问都会手动完成的两个 CSV VLOOKUP 操作。

  semrush-pp-cli keyword gap myco.com competitor1.com competitor2.com --database us --kd-max 40 --agent
  

• backlink gap — 查找链接到竞争对手但未链接到你的引荐域名，并按权威度评分筛选。

  直接找出可交给外展工作流的链接建设目标。

  semrush-pp-cli backlink gap myco.com competitor.com --min-ascore 70 --agent
  

• domain regions — 一次性在多个国家数据库中运行 Domain Overview，并将所有行连同数据库键一起持久化，以便后续进行跨区域变化查询。

  让 Agent 只需一次调用，就能回答“这个域名在我们的前 5 大市场表现如何”，而不必调用五次。

  semrush-pp-cli domain regions apple.com --databases us,uk,de,fr,it --agent
  

竞争对手均未提供的 SEO 内容模式

• audit triage — 按加权问题严重程度为 Site Audit 页面排序（错误 x3、警告 x1、提示 x0.1），以便优先修复影响最大的页面。

  将 Site Audit 导出结果转化为优先级明确的行动清单，供 Agent 交给下一步处理。

  semrush-pp-cli audit triage 12345 --top 20 --agent
  

• serp-features — 按时间序列查看某个已跟踪关键词出现和消失过的 SERP 功能（精选摘要、“用户还问了”、视频、图片包）。

  告诉内容策略 Agent 机会（例如，精选摘要位置空出）何时出现或关闭。

  semrush-pp-cli serp-features 'best running shoes' --since 30d --agent
  

• cannibalization — 列出同一域名在多个 URL 上排名的短语（这是一个已知的 SEO 问题），并显示这些 URL 及其各自排名位置。

  通过一条命令揭示高价值 SEO 问题——大多数顾问都会收费调查此问题。

  semrush-pp-cli cannibalization apple.com --database us --agent
  

命令参考

account — 账户实用工具（API 单位余额）

• semrush-pp-cli account — 获取剩余 API 单位余额（免费探测；不消耗单位）

audit — Site Audit：启用、运行、列出快照、深入查看问题和页面

• semrush-pp-cli audit campaign-info — 获取 Site Audit 活动配置和当前状态。
• semrush-pp-cli audit edit — 编辑 Site Audit 活动设置（页面限制、用户代理、范围等）。
• semrush-pp-cli audit enable — 在项目中启用 Site Audit。每个项目仅需一次。免费（配置调用）。
• semrush-pp-cli audit history — Site Audit 快照历史（问题数量和评分的时间序列）。
• semrush-pp-cli audit issue — 获取快照中某个问题的详细报告（受影响页面、状态）。
• semrush-pp-cli audit issue-catalog — 获取所有 Site Audit 问题代码的文本说明。免费。
• semrush-pp-cli audit page — 获取某个已抓取页面的完整详情（发现的问题、状态、指标）。
• semrush-pp-cli audit page-by-url — 根据给定 URL，在快照中查找 page_id。
• semrush-pp-cli audit run — 触发新的 Site Audit 抓取。启动免费；计入页面额度池。
• semrush-pp-cli audit snapshot-info — 获取快照的汇总数量（错误／警告／提示、检查总数）。
• semrush-pp-cli audit snapshots — 列出项目的 Site Audit 快照。免费（不消耗 API 单位）。

backlink — 反向链接：概览、列表、引荐域名／IP、锚文本、竞争对手、历史

• semrush-pp-cli backlink anchors — 锚文本。每行 40 个单位。指向目标的反向链接中使用的锚文本。
• semrush-pp-cli backlink authority-score — 权威度评分概况。每次请求 40 个单位。目标的 Semrush 权威度评分（AS）快照。
• semrush-pp-cli backlink categories — 类别。每行 40 个单位。引用域名所属的主题类别。
• semrush-pp-cli backlink categories-profile — 类别概况。每次请求 40 个单位。目标所属的主题类别及置信度评分。
• semrush-pp-cli backlink compare-batch — 批量比较。每个域名每次请求 40 个单位。并排查看最多 200 个域名的反向链接统计数据。
• semrush-pp-cli backlink compare-refdomains — 按引用域名比较。每行 40 个单位。查看哪些引用域名链接到多个目标（矩阵）。
• semrush-pp-cli backlink competitors — 反向链接竞争对手。每行 40 个单位。反向链接概况与目标相似的域名。
• semrush-pp-cli backlink geo — 按国家/地区划分的引用域名。每行 40 个单位。引用域名的国家/地区分布。
• semrush-pp-cli backlink history — 历史数据（反向链接）。每行 40 个单位。反向链接/引用域名数量和 AS 的时间序列。
• semrush-pp-cli backlink indexed-pages — 已索引页面。每行 40 个单位。目标上获得反向链接的页面。
• semrush-pp-cli backlink list — 反向链接。每行 40 个单位。指向目标的单条反向链接。
• semrush-pp-cli backlink overview — 反向链接概览。每次请求 40 个单位。反向链接总数、引用域名数、引用 IP 数、关注链接比例和 AS。
• semrush-pp-cli backlink referring-domains — 引用域名。每行 40 个单位。链接到目标的去重域名。
• semrush-pp-cli backlink referring-ips — 引用 IP。每行 40 个单位。托管引用域名的去重 IP 地址。
• semrush-pp-cli backlink tld — 顶级域名分布。每行 40 个单位。按顶级域名划分的引用域名分布。

domain — 域名分析：概览、自然搜索/付费关键词、竞争对手、页面、广告历史

• semrush-pp-cli domain ad-copies — 域名广告文案。每行 20 个单位。某个域名投放过的独特广告创意（标题 + 描述）。
• semrush-pp-cli domain ad-history — 域名广告历史记录。每行 100 个单位。某个域名针对付费关键词投放过的广告文案的 12 个月存档。
• semrush-pp-cli domain compare — 域名对比。每行 80 个单位。并排比较 2-5 个域名之间的关键词重合情况。
• semrush-pp-cli domain competitors-organic — 自然搜索竞争对手。每行 40 个单位。与目标域名共享自然关键词的域名。
• semrush-pp-cli domain competitors-paid — 付费搜索竞争对手。每行 40 个单位。与目标域名的 Google Ads 关键词集重合的域名。
• semrush-pp-cli domain competitors-pla — PLA 竞争对手。每行 40 个单位。与目标域名的 Google Shopping PLA 关键词集重合的域名。
• semrush-pp-cli domain organic-keywords — 域名自然搜索关键词。每行 30 个单位。某个域名在 Google 自然搜索结果前 100 名中排名的关键词。
• semrush-pp-cli domain organic-pages — 域名自然搜索页面。每行 30 个单位。某个域名按流量排名靠前的自然搜索着陆页。
• semrush-pp-cli domain overview — 域名概览（单个数据库）。每行 10 个单位。某个区域数据库中的实时或历史排名。
• semrush-pp-cli domain overview-all — 域名概览（所有数据库）。每行 10 个单位。约 140 行，涵盖所有区域数据库。
• semrush-pp-cli domain overview-history — 域名概览（历史记录）。每行 10 个单位。单个数据库的月度历史排名（可追溯至 2012-2016 年）。
• semrush-pp-cli domain paid-keywords — 域名付费搜索关键词。每行 30 个单位。某个域名在 Google Ads 中购买的关键词。
• semrush-pp-cli domain pla-copies — 域名 PLA 文案。每行 20 个单位。独特的 PLA 广告创意（标题、价格、商店）。
• semrush-pp-cli domain pla-keywords — 域名 PLA 搜索关键词。每行 30 个单位。某个域名的 Google Shopping PLA 关键词。
• semrush-pp-cli domain subdomains — 域名自然搜索子域名。每行 30 个单位。按自然流量排名的某个域名的子域名。

keyword — 关键词研究报告（搜索量、难度、相关关键词、SERP、广告历史记录）

• semrush-pp-cli keyword ads-history — 关键词广告历史记录。每行 100 个单位。过去 12 个月内对该关键词出价的广告主存档。
• semrush-pp-cli keyword batch — 批量关键词概览。每行 10 个单位。单次调用最多查询 100 个关键词。
• semrush-pp-cli keyword broad-match — 广泛匹配关键词。每行 20 个单位。种子词的词组匹配变体。
• semrush-pp-cli keyword difficulty — 关键词难度。每行 50 个单位。一个或多个关键词的 KDI（0-100）。
• semrush-pp-cli keyword organic-serp — 关键词的自然搜索结果（SERP）。每行 10 个单位。某个词组的自然搜索排名靠前的 URL。
• semrush-pp-cli keyword overview — 关键词概览（单个数据库）。每行 10 个单位。单个数据库中的搜索量、CPC、竞争度和结果数量。
• semrush-pp-cli keyword overview-all — 关键词概览（所有数据库）。每行 10 个单位。约 140 行，涵盖所有区域数据库。
• semrush-pp-cli keyword paid-serp — 关键词的付费搜索结果（SERP）。每行 20 个单位。对该词组出价的广告主。
• semrush-pp-cli keyword questions — 词组问题。每行 40 个单位。包含种子词组的疑问形式关键词。
• semrush-pp-cli keyword related — 相关关键词。每行 40 个单位。与种子词组语义相关的关键词。

project — 管理 Semrush 项目（用于 Position Tracking、Site Audit、Listings 的容器）

• semrush-pp-cli project create — 创建新的 Semrush 项目（容器），并指定名称和根域名。
• semrush-pp-cli project delete — 删除项目。CLI 要求使用 --yes 确认；否则仅执行试运行。
• semrush-pp-cli project get — 按 ID 获取单个项目。免费（不消耗 API 单位）。
• semrush-pp-cli project list — 列出账户中的所有项目。免费（不消耗 API 单位）。
• semrush-pp-cli project update — 更新现有项目的名称/URL。

subdomain — 子域名分析：概览、自然/付费关键词、页面

• semrush-pp-cli subdomain organic-keywords — 子域名自然搜索关键词。每行 30 个单位。
• semrush-pp-cli subdomain organic-pages — 子域名自然搜索页面。每行 30 个单位。
• semrush-pp-cli subdomain overview — 子域名概览（单个数据库）。每行 10 个单位。
• semrush-pp-cli subdomain overview-all — 子域名概览（所有数据库）。每行 10 个单位。
• semrush-pp-cli subdomain overview-history — 子域名概览（历史数据）。每行 10 个单位。每月历史排名。
• semrush-pp-cli subdomain paid-keywords — 子域名付费搜索关键词。每行 30 个单位。

subfolder — 子文件夹分析：概览、自然/付费关键词、页面

• semrush-pp-cli subfolder organic-keywords — 子文件夹自然搜索关键词。每行 30 个单位。
• semrush-pp-cli subfolder organic-pages — 子文件夹自然搜索页面。每行 30 个单位。
• semrush-pp-cli subfolder organic-pages-unique — 子文件夹自然搜索页面（唯一）。每行 30 个单位。子文件夹中排名靠前的唯一自然搜索落地页。
• semrush-pp-cli subfolder overview — 子文件夹概览（单个数据库）。每行 10 个单位。
• semrush-pp-cli subfolder overview-all — 子文件夹概览（所有数据库）。每行 10 个单位。
• semrush-pp-cli subfolder overview-history — 子文件夹概览（历史数据）。每行 10 个单位。每月历史排名。
• semrush-pp-cli subfolder paid-keywords — 子文件夹付费搜索关键词。每行 30 个单位。

tracking — 排名跟踪：创建活动、管理关键词/标签/竞争对手、自然搜索和付费搜索报告

• semrush-pp-cli tracking campaigns — 列出项目下的排名跟踪活动。用于查找 campaign_id。

• semrush-pp-cli tracking competitors-add — 将竞争对手添加到现有排名跟踪活动。

• semrush-pp-cli tracking competitors-remove — 从现有排名跟踪活动中移除竞争对手。

• semrush-pp-cli tracking create — 在项目中创建排名跟踪活动。

• semrush-pp-cli tracking dates — 跟踪活动的可用快照日期（在其他位置通过 --snapshot 标志使用）。

• semrush-pp-cli tracking emails-disable — 禁用排名跟踪活动的每周状态邮件。

• semrush-pp-cli tracking emails-enable — 启用排名跟踪活动的每周状态邮件。

• semrush-pp-cli tracking keywords-add — 将关键词添加到现有排名跟踪活动。

• semrush-pp-cli tracking keywords-remove — 从现有排名跟踪活动中移除关键词。

• semrush-pp-cli tracking location-search — 通用位置搜索（返回城市/地区/国家/地区的位置 ID）。

• semrush-pp-cli tracking organic-competitors — 发现自然搜索竞争对手（在跟踪的关键词组中自动检测并排名的竞争对手）。

• semrush-pp-cli tracking organic-landings — 按跟踪关键词流量排名的顶级自然搜索落地页。

• semrush-pp-cli tracking organic-overview — 自然搜索概览报告（指定日期范围内的可见度、预估流量、平均排名）。

• semrush-pp-cli tracking organic-positions — 按关键词划分的自然搜索排名报告。支持标签筛选和竞争对手比较。

• semrush-pp-cli tracking organic-visibility — 指定日期范围内的自然搜索可见度（声量份额）指数。

• semrush-pp-cli tracking paid-competitors — 发现 AdWords 竞争对手（自动检测付费搜索竞争对手）。

• semrush-pp-cli tracking paid-landings — 按跟踪关键词流量排名的顶级付费（AdWords）落地页。

• semrush-pp-cli tracking paid-overview — AdWords 概览报告（指定日期范围内的付费搜索可见度、预估流量）。

• semrush-pp-cli tracking paid-positions — 按关键词划分的付费（AdWords）排名报告。

• semrush-pp-cli tracking paid-visibility — 指定日期范围内的 AdWords 可见度（声量份额）指数。

• semrush-pp-cli tracking tags-add — 为排名跟踪活动中现有的关键词添加标签。

• semrush-pp-cli tracking tags-remove — 从排名跟踪活动中现有的关键词移除标签。 url — URL 级分析：概览、自然搜索／付费关键词

• semrush-pp-cli url organic-keywords — URL 自然搜索关键词。每行 30 个单位。此 URL 自然排名的关键词。

• semrush-pp-cli url overview — URL 概览（一个数据库）。每行 10 个单位。

• semrush-pp-cli url overview-all — URL 概览（所有数据库）。每行 10 个单位。

• semrush-pp-cli url overview-history — URL 概览（历史）。每行 10 个单位。URL 的月度历史排名。

• semrush-pp-cli url paid-keywords — URL 付费搜索关键词。每行 30 个单位。此 URL 投放广告的关键词。

新鲜度约定

此 CLI 仅对已注册、由存储支持的读取命令路径负责有限范围的新鲜度。在 --data-source auto 模式下，这些路径会检查 sync_state，并可能在读取本地数据之前执行有限范围的刷新。--data-source local 不会刷新数据。--data-source live 会读取 API，且不会修改本地存储。设置 SEMRUSH_NO_AUTO_REFRESH=1 可跳过新鲜度钩子，同时不更改数据源选择。

覆盖的路径：

• semrush-pp-cli project
• semrush-pp-cli project get
• semrush-pp-cli project list

JSON 输出使用生成的来源信息封装时，新鲜度元数据位于 meta.freshness。请将其视为该命令路径的当前缓存新鲜度，而非完整历史回填或 API 特定增强的保证。

查找合适的命令

知道想做什么，但不知道该用哪个命令时，可以直接询问 CLI：

semrush-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有足够可信的匹配项——请改用 --help，或使用范围更窄的查询。

配方

周一基线 + 周五差异

semrush-pp-cli snapshot tag monday-baseline

同步已跟踪的域名和关键词后，为快照添加标签。周五重新同步，然后运行 snapshot diff monday-baseline today 查看本周的变化。

查找竞争对手排名靠前的关键词机会

semrush-pp-cli keyword gap myco.com competitor.com --database us --kd-max 40 --json --select phrase,nq,kd

一步完成集合差异查询——筛选出难度合理、竞争对手排名靠前而你没有排名的关键词。

根据竞争对手建立潜在链接对象列表

semrush-pp-cli backlink gap myco.com competitor.com --min-ascore 70 --json --select domain,domain_ascore,backlinks_num

找出权威度 70+、链接到竞争对手但未链接到你的网站，并可直接传入外联工作流的引用域名。

评估最新的 Site Audit

semrush-pp-cli audit triage 12345 --top 20 --agent

有 Site Audit 快照后，获取影响最大的 20 个页面，按错误 × 3 + 警告 × 1 + 提示 × 0.1 加权排序。

查看本月积分的去向

semrush-pp-cli budget --since 30d --group-by command --agent

按命令汇总本地 credit_log；列出消耗最多的命令，方便你限制调用或使用缓存。

身份验证设置

从 Subscription Info → API Units 页面获取 SEMRUSH_API_KEY 并进行设置。此 CLI 使用与官方文档相同的 v3 查询参数身份验证，并通过免费余额端点检查配置，因此验证密钥是否有效不会消耗积分。

运行 semrush-pp-cli doctor 验证配置。

Agent 模式

为任意命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。对于冗长 API，这对缩小上下文至关重要：

  semrush-pp-cli backlink list mock-value --type example-value --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不发送

• 适合离线使用 — 同步／搜索命令在本地 SQLite 存储可用时可以使用它

• 非交互式 — 绝不显示提示，所有输入都通过标志传入

• 显式重试 — 仅当已存在的创建操作也应视为成功时才使用 --idempotent；仅当缺失的删除目标也应视为成功时才使用 --ignore-missing

响应封装

从本地存储或 API 读取数据的命令会将输出封装在来源信息中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

从 .results 解析数据，并通过 .meta.source 判断数据来自实时数据还是本地数据。仅当标准输出连接到终端，且未设置任何机器格式标志（--json、--csv、--compact、--quiet、--plain、--select）时，才会将易读的 N results (live) 摘要打印到 stderr；管道或 Agent 消费者以及显式指定格式的运行，都会在 stdout 输出纯 JSON。

Agent 反馈

当你（或 Agent）发现这个 CLI 有任何不妥之处时，请记录下来：

semrush-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
semrush-pp-cli feedback --stdin < notes.txt
semrush-pp-cli feedback list --json --limit 10

条目会保存在本地 ~/.local/share/semrush-pp-cli/feedback.jsonl。只有在设置了 SEMRUSH_FEEDBACK_ENDPOINT，并且传入了 --send 或设置了 SEMRUSH_FEEDBACK_AUTO_SEND=true 时，条目才会通过 POST 发送。默认情况下仅保存在本地。

记录让你感到意外的地方，而不是提交错误报告。简短、具体，写成一行：这才是能不断积累价值的部分。

输出传递

每条命令都接受 --deliver <sink>。输出会发送到指定的接收端，同时输出到 stdout（或取代 stdout），这样 Agent 无需手动通过管道传递，就能路由命令结果。支持三种接收端：

接收端	效果
stdout	默认；仅写入 stdout
file:<path>	原子写入输出到 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（当使用 --compact 时，内容类型为 application/json 或 application/x-ndjson）

遇到未知方案时会拒绝执行，并返回包含受支持方案列表的结构化错误。Webhook 失败时会返回非零状态码，并在 stderr 记录 URL 和 HTTP 状态码。

命名配置

配置档案是一组保存的标志值，可在多次调用中重复使用。如果定时运行的 Agent 每次都以相同配置调用同一命令，就可以使用配置档案——这就是 HeyGen 的“Beacon”模式。

semrush-pp-cli profile save briefing --json
semrush-pp-cli --profile briefing backlink list mock-value --type example-value
semrush-pp-cli profile list --json
semrush-pp-cli profile show briefing
semrush-pp-cli profile delete briefing --yes

显式标志始终优先于配置档案中的值；配置档案中的值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置档案，以便 Agent 在运行时发现它们。

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
4	需要身份验证
5	API 错误（上游问题）
7	请求过于频繁（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 semrush-pp-cli --help 的输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并附带 --agent）

安装 MCP 服务

1. 安装 MCP 服务：

   go install github.com/mvanhorn/printing-press-library/library/marketing/semrush/cmd/semrush-pp-mcp@latest
   

2. 在 Claude Code 中注册：

   claude mcp add semrush-pp-mcp -- semrush-pp-mcp
   

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which semrush-pp-cli 如果未找到，则提供安装选项（参见本技能顶部的先决条件）。
2. 根据用户查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

   semrush-pp-cli <command> [subcommand] [args] --agent
   

4. 如果存在歧义，则查看子命令帮助：semrush-pp-cli <command> --help。