Serpzilla SEO 客座发稿

说明

本技能面向希望提升网站反向链接（backlink）质量的 SEO 专家与网站管理员。

它允许您通过 OpenClaw 自动化完成客座发稿（即在供稿网站上发布文章，从而将链接权重传递至您的推广资源）的搜索与采购流程。平台交互通过 Serpzilla MCP 服务器完成，该服务器由 mcporter 工具进行管理。

前提条件

在运行 OpenClaw 的服务器上，需预先安装并配置以下组件：

1. Docker —— 用于在隔离容器中运行 Serpzilla MCP 服务器。
2. Node.js 和 npm —— 用于安装和运行 mcporter。
3. OpenClaw —— 代理运行时环境。

在使用任何 Serpzilla 命令前，请先执行 npx mcporter list serpzilla 验证 MCP 服务器是否已成功注册。

初步配置

要完整使用本技能，您需完成 Serpzilla API 的注册及连接配置。

1. 注册与获取 API Token

1. 在 Serpzilla.com 上以广告主身份完成注册。
2. 访问安全设置页面：https://passport.serpzilla.com/security/token/。
3. 复制您的 API token，并牢记注册时使用的 登录名（通常为邮箱地址）。

2. 安装 mcporter 并添加 Serpzilla MCP 服务器

mcporter 是一款用于管理 MCP 服务器的命令行工具，OpenClaw 通过它与外部服务通信。

全局安装 mcporter：

npm install -g mcporter

添加 Serpzilla MCP 服务器：

需提示用户输入以下环境变量值：
SERPZILLA_LOGIN（用户在 serpzilla.com 注册时选择的登录名，通常为邮箱地址）
SERPZILLA_API_TOKEN（用户收到的 API token）

请运行以下命令，并将 XXX 和 YYY 替换为用户实际值：

npx mcporter config add serpzilla --stdio "docker run -i --rm --env SERPZILLA_LOGIN=XXX --env SERPZILLA_API_TOKEN=YYY stanislavusbest/serpzilla-mcp-stdio-server:v1.0.8"

3. 验证配置

检查 MCP 服务器是否已成功添加：

npx mcporter list serpzilla

技能使用方法

完成初步配置后，本技能即可投入使用。以下为采购客座发稿的标准工作流程。

在 Serpzilla 平台中，采购 Guest Post 所涉及的核心实体如下：

• Project（项目） —— 包含下述所有实体的容器。开始发稿前必须创建项目。项目按特定域名创建，但项目内可推广任意其他域名，无限制。
• URL（目标网址） —— 待进行 SEO 推广的页面地址。所采购的 Guest Post 将用于推广该页面。URL 与项目绑定。
• Article（文章） —— 拟发布在供稿网站上的内容。可上传至 Serpzilla 系统，供采购发稿位时调用。上传后，文章需经平台审核员审核，因此具有状态属性。Article 与项目绑定。
• Text（锚文本） —— 在供稿页面/网站中插入链接所使用的锚文本。若用户已上传 Article，则 Text 和推广 URL 将自动确定。Text 与项目绑定。
• Content（内容） —— Article 与 Content 的通用抽象实体，亦有其独立的状态流转机制。
• Placement（发稿位） —— 正在采购的 Guest Post 发稿位。其生命周期体现为状态流转过程。Placement 与 Text 和 URL 绑定。

发稿位类型说明：

获取当前用户信息（含账户余额）：

npx mcporter call serpzilla.get_user_info

为用户账户充值，请引导其访问：https://passport.serpzilla.com/deposit/

步骤 1：为待推广网站创建项目

在 Serpzilla 中为您自己的域名创建一个项目。请将 YOUR_SITE.COM 替换为您的实际网站域名（不含 https://）：

npx mcporter call serpzilla.create_project domain=YOUR_SITE.COM

重要提示： 请保存返回的 PROJECT_ID（即响应中的 ID 字段），后续步骤将用到。

项目创建成功后，Serpzilla 将自动生成：

• 一个 URL 实体，其值为 domain（例如 https://YOUR_SITE.COM）
• 一个 Text 实体，其默认锚文本为该域名

您后续可为具体落地页和不同锚文本添加更多 URL 和 Text。

查看所有已有项目：

npx mcporter call serpzilla.list_projects

步骤 2：内容准备

您必须在采购发稿位之前上传文章。上传后，文章将由 Serpzilla 审核员进行审核。仅状态为 approved 的文章可用于发稿采购。

添加文章：

npx mcporter call serpzilla.add_article project_id=PROJECT_ID url='FULL_URL' title='ARTICLE_TITLE' 
meta_title="ARTICLE_META_TITLE" body='ARTICLE_BODY'

参数说明：

• url —— 完整的推广网址（含 https://），例如 https://yoursite.com/product
• title —— 文章内部标题（仅在 Serpzilla UI 中可见）
• meta_title —— 站长发布时所用的 meta 标题
• body —— 文章 HTML 内容，其中已嵌入您的反向链接

文章审核流程：

• 上传后，文章状态为 pending。
• 审核通常需 1–2 个工作日。
• 若审核通过，状态变为 approved，即可用于采购。
• 若被拒绝，请根据反馈原因修改后重新上传。

查看文章状态：

npx mcporter call serpzilla.get_project_content_list project_id=PROJECT_ID

对于 review、link、archive 类型

无需上传文章。Serpzilla 将直接使用 text_id（锚文本）和 url_id（推广页面）。站长将按对应类型撰写内容。

步骤 3：搜索供稿网站

凭借您的 PROJECT_ID，可搜索支持所需发稿位类型的可用供稿网站。

基础搜索命令：

npx mcporter call serpzilla.search_sites project_id=PROJECT_ID link_type=link

合法的 link_type 值包括：news、review、link、archive。

查看全部可用筛选条件（语言、价格区间、DR 等）：

npx mcporter list serpzilla --schema --json

获取特定供稿网站的详细信息：

npx mcporter call serpzilla.get_site_info site_id=SITE_ID

该命令将返回包括 DR、流量、语言、状态、价格、发稿示例等在内的多项指标。

步骤 4：采购 Guest Post

重要提示 —— 任何采购操作前均须获得用户明确确认。

在执行采购前，代理必须完成以下步骤：

1. 调用 get_user_info 获取当前账户余额。
2. 调用 get_site_info site_id=SITE_ID 获取所选供稿网站的报价。
3. 向用户提供以下信息：
   • 网站 URL 及报价
   • 当前账户余额
   • 采购后剩余余额（余额 − 报价）
4. 向用户请求明确确认，方可继续采购流程。
5. 仅在收到用户确认后，才可执行 purchase_placement。

若用户未确认，请勿继续采购。

当您已具备以下必要参数时：

• PROJECT_ID
• SITE_ID（来自搜索结果）
• 对于 news 类型：已通过审核的 article_id 和 url_id
• 对于 review、link、archive 类型：需 url_id 和 text_id

重要提示： 采购时，search_history_id 参数必须始终设为空字符串 ""。

各类型采购示例：

4.1 采购 news 类型发稿位（广告主提供文章）

npx mcporter call serpzilla.purchase_placement project_id=PROJECT_ID link_type=news 
  site_id=SITE_ID article_id=ARTICLE_ID url_id=URL_ID search_history_id=""

可选参数：is_content_need_approval=true —— 若启用，发稿将在站长开始执行前等待您的审批。适用于您希望审阅最终上下文场景。

4.2 采购 review 类型发稿位（站长提供文章）

npx mcporter call serpzilla.purchase_placement project_id=PROJECT_ID link_type=review 
  site_id=SITE_ID url_id=URL_ID text_id=TEXT_ID search_history_id=""

4.3 采购 link 类型发稿位（In The News – 链接插入）

npx mcporter call serpzilla.purchase_placement project_id=PROJECT_ID link_type=link 
  site_id=SITE_ID url_id=URL_ID text_id=TEXT_ID search_history_id=""

4.4 采购 archive 类型发稿位（In The Archive – 链接插入）

npx mcporter call serpzilla.purchase_placement project_id=PROJECT_ID link_type=archive 
  site_id=SITE_ID url_id=URL_ID text_id=TEXT_ID search_history_id=""

查看已采购的发稿位：

npx mcporter call serpzilla.get_project_placements project_id=PROJECT_ID

步骤 5：已采购发稿位的管理

重要提示 —— 执行任何发稿位操作前均须获得用户明确确认。

许多发稿位操作涉及资金变动：

• approve_seo / approve_content_seo —— 向站长释放款项
• cancel_seo / cancel_from_* —— 可能触发退款或费用作废
• terminate_seo —— 永久移除已批准的反向链接
• approve_from_arbitration_seo —— 在争议处理中裁定您胜出

在执行任何 perform_placement_action 前，代理必须完成以下步骤：

1. 向用户说明即将执行的操作及其财务影响。
2. 向用户请求明确确认，方可继续操作。
3. 仅在收到用户确认后，才可执行该操作。

若用户未确认，请勿继续执行该操作。

完成发稿位采购后，其生命周期通过一系列状态及状态转换进行管理。您可通过执行特定操作来推动发稿进度、申请修改、取消订单，或处理计费异常、采购失败等边缘情况。

所有操作均通过 MCP 工具执行：

npx mcporter call serpzilla.perform_placement_action placement_ids=PLACEMENT_ID action=ACTION_NAME

下表列出了所有可用于 SEO 场景的操作。针对每个操作，我们说明了其用途、源状态、目标状态及相关注意事项。

附加资源

• Serpzilla API 文档