2025/12/06

MyBacklinks MCP 入门指南：让 AI 管理你的外链

学习如何使用 MCP（模型上下文协议）将 Claude Code、Cursor 等 AI 助手连接到 MyBacklinks，实现自动化的项目和外链管理。

MyBacklinks MCP 入门指南

MyBacklinks MCP（模型上下文协议）服务器让你能够直接从 AI 开发工具（如 Claude Code、Cursor 和 OpenAI Codex）管理项目、外链和数据分析。本指南将介绍设置、OAuth 认证和可用工具的使用方法。

什么是 MCP？

模型上下文协议（MCP）是由 Anthropic 开发的开放标准，允许 AI 助手安全地连接到外部数据源和工具。MyBacklinks MCP 服务器实现了该协议，使用 OAuth 2.0 动态客户端注册进行安全认证。

功能特点

🔐 安全的 OAuth 2.0 认证 - 支持动态客户端注册和 PKCE 流程
🚀 零配置设置 - 只需添加 URL，认证自动完成
🛠️ 16 个统一工具 - 管理项目、外链、资源、数据分析、域名研究、状态查询和网页抓取
🔄 自动令牌刷新 - 无缝的会话管理
🎯 多平台支持 - Claude Code、Cursor、Codex 等

快速开始

支持的客户端

客户端	传输协议	OAuth
Claude Code	Streamable HTTP	✅ 内置
Cursor	Streamable HTTP	✅ 内置
OpenAI Codex	Streamable HTTP	✅ 内置
移动端应用	Streamable HTTP	✅ OAuth 或 API Key

配置

新增：直接使用 npm CLI

如果你更偏好终端工作流，可以直接安装已发布的 CLI：

npm install -g @mybacklinks/cli
mybacklinks login
mybacklinks status
mybacklinks list-projects
mybacklinks fetch-dr-by-domain --domain example.com

CLI 和 MCP 复用同一套后端工具面。login 同时支持 OAuth 门户流程和 --api-key。

只需将 MCP 服务器 URL 添加到客户端配置中：

Claude Code 配置

方式一：命令行（推荐）

# 添加到用户范围（所有项目可用）
claude mcp add --transport http --scope user mybacklinks https://mybacklinks.app/mcp

# 或仅添加到当前项目
claude mcp add --transport http mybacklinks https://mybacklinks.app/mcp

# 验证是否添加成功
claude mcp list

方式二：配置文件 (~/.claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

Cursor 配置

在项目中添加 .cursor/mcp.json：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

OpenAI Codex 配置

命令行：

codex mcp add mybacklinks --url https://mybacklinks.app/mcp

或配置文件 (~/.codex/mcp.toml)：

[[mcp_servers]]
name = "mybacklinks"
url = "https://mybacklinks.app/mcp"

移动端配置

想要随时随地管理你的外链？移动端 MCP 客户端支持两种认证方式：

方式一：OAuth 认证（推荐）

如果你的移动端 MCP 客户端支持 OAuth：

添加新服务器，URL 填写：https://mybacklinks.app/mcp
点击「连接」- 应用会自动处理 OAuth 认证
在手机浏览器中完成登录
返回应用，开始使用 MCP 工具！

方式二：API Key + 自定义 Header

如果你的移动端 MCP 客户端不支持 OAuth，可以使用 API Key 认证：

前往 MyBacklinks API Keys 页面
点击「创建 API Key」并复制生成的密钥
在移动端 MCP 客户端中，添加新服务器，URL 填写：https://mybacklinks.app/mcp
配置自定义 Header：
- Header 名称：Authorization
- Header 值：Bearer YOUR_API_KEY
保存并连接 - 即可开始使用 MCP 工具！

API Key 配置示例：

服务器 URL: https://mybacklinks.app/mcp
自定义 Headers:
  Authorization: Bearer mbk_xxxxxxxxxxxxxxxxxxxx

移动端使用场景：

通勤时查看项目状态
发现外链机会时快速添加
随时随地查看分析报告
实时响应外链状态变化

提示： OAuth 更安全，令牌可自动刷新和撤销。API Key 配置更简单，但请妥善保管，切勿公开分享。

首次认证

首次连接时，你的 AI 客户端会自动：

从 /.well-known/oauth-authorization-server 发现 OAuth 元数据
注册为动态客户端（RFC 7591）
打开浏览器让你登录
安全存储令牌供后续请求使用

无需手动设置——只需配置 URL 即可开始使用！

可用的 MCP 工具

连接后，你的 AI 助手可以使用以下 16 个工具：

项目管理

`listProjects`

列出所有项目及其元数据。

参数：

cursor（可选）：分页游标
limit（可选）：返回最大数量（1-50）

示例提示：

显示我的所有项目

返回内容：

项目 ID、名称、域名
状态（active/archived）
创建和更新时间

`getProject`

获取特定项目的详细信息。

参数：

projectId（可选）：项目 ID
domain（可选）：域名（如 "example.com"），可作为 projectId 的替代参数

注意：projectId 和 domain 二选一，至少提供一个。

示例：

获取我的 LoveMoney 项目详情

获取域名 lovemoney.app 的项目详情

返回内容：

项目元数据
各状态的外链数量（待提交、已提交、已收录、已拒绝）
资源数量
最后分析同步日期

外链管理

`listProjectBacklinks`

列出特定项目的所有外链。

参数：

projectId（必需）：项目 ID
status（可选）：按状态过滤（pending、submitted、indexed、rejected、removed）
resourceDomain（可选）：按来源域名过滤
anchorText（可选）：按锚文本子串过滤
targetUrl（可选）：按目标页 URL 子串过滤
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）

示例：

显示我项目的所有已收录外链

`getProjectBacklinkDetail`

获取特定项目外链的详细信息。

参数：

backlinkId（必需）：项目外链 ID

示例：

显示外链 abc123 的详情

`updateProjectBacklinks`

创建或更新一个或多个项目外链。

参数：

projectId（必需）：项目 ID
backlinkId（可选）：更新时的外链 ID
resourceId（可选）：外链资源 ID（会自动从资源填充 backlinkUrl）
targetUrl（创建时必需）：目标 URL（你想要获取外链的页面）
backlinkUrl（可选）：外链所在的 URL
anchor（可选）：锚文本
status（可选）：外链状态
notes（可选）：备注
items（可选）：批量更新时传入的数组负载

示例：

为我的项目添加一个新外链：
- 目标 URL: https://myapp.com
- 外链 URL: https://producthunt.com/posts/myapp
- 锚文本: "AI 驱动的工具"
- 状态: submitted

也可以通过 CLI 执行同样的流程：

mybacklinks update-project-backlinks \
  --project-id <project-id> \
  --target-url https://myapp.com \
  --backlink-url https://producthunt.com/posts/myapp \
  --anchor "AI 驱动的工具" \
  --status submitted

资源管理

`listBacklinkResources`

列出可用的外链资源（目录、论坛等），你可以在这些网站提交你的项目。

参数：

cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：过滤条件对象：
- type：资源类型（如 "guest_post"、"directory"）
- payment：付费类型（如 "free"、"paid"）
- drMin：最低域名评级
- drMax：最高域名评级

示例：

找一些高 DR（> 50）的免费外链提交网站

`discoverBacklinkOpportunities`

发现项目的外链提交机会。返回尚未使用的外链资源，帮助你找到新的外链提交渠道。

参数：

projectId（可选）：要检查的项目 ID
domain（可选）：域名（如 "example.com"），可作为 projectId 的替代参数
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：与 listBacklinkResources 相同的过滤条件

注意：projectId 和 domain 二选一，至少提供一个。

示例：

发现我 SaaS 项目还可以提交外链的机会

查找 lovemoney.app 域名的外链提交机会

`addBacklinkResource`

新增外链资源到个人数据库。如果已存在相同域名的资源，将拒绝添加。

参数：

domain（必需）：资源域名（如 "example.com"）。协议前缀和路径会被自动移除
type（必需）：资源类型（blog、directory、forum、social、other）
submissionUrl（可选）：提交外链的完整 URL
paymentType（可选）：付费类型（free、paid、freemium）。默认：free
submissionMethod（可选）：提交方式（如 "comment"、"guest post"、"profile link"）
howToSubmit（可选）：AI Agent 提交外链的自然语言指引
dr（可选）：域名评级（0-100）
traffic（可选）：预估月流量
notes（可选）：关于此资源的备注

示例：

添加一个新的外链资源：
- 域名: indiehackers.com
- 类型: forum
- 付费: free
- DR: 70
- 备注: SaaS 创始人的好社区

错误处理： 如果域名已存在于你的数据库中，工具将返回错误码 duplicate_domain，并包含已存在资源的 ID。

`updateBacklinkResource`

更新已有的外链资源。只有提供的字段会被更新，域名不可修改。

参数：

id（必需）：要更新的资源 ID（来自 listBacklinkResources）
submissionUrl（可选）：提交外链的完整 URL
type（可选）：资源类型（blog、directory、forum、social、other）
paymentType（可选）：付费类型（free、paid、freemium）
submissionMethod（可选）：提交方式（设置为 null 可清除）
howToSubmit（可选）：AI Agent 提交外链的自然语言指引（设置为 null 可清除）
dr（可选）：域名评级 0-100（设置为 null 可清除）
traffic（可选）：预估月流量（设置为 null 可清除）
notes（可选）：备注（设置为 null 可清除）

示例：

更新 indiehackers.com 资源：
- howToSubmit: "前往 /new，撰写文章，选择适当的群组，然后点击 Post"
- DR: 72
- 备注: 最近域名增长后更新的 DR

返回内容：

更新后的完整资源对象（id、domain、type、paymentType、submissionUrl、submissionMethod、howToSubmit、dr、traffic、notes、updatedAt）

数据分析

`getProjectAnalytics`

获取项目的分析数据。

参数：

projectId（必需）：项目 ID
range（可选）：时间范围（30d 或 90d）

示例：

显示我项目过去 30 天的 SEO 分析数据

域名研究（需消耗积分）

这些工具允许你研究任意域名的 SEO 指标和外链。每次成功的 API 调用都会消耗积分。

`getDomainMetrics`

查询任意域名的 SEO 指标，包括 DR、流量、外链数量等。

参数：

domain（必需）：要查询的域名（如 "example.com"）

消耗： 1 积分/次

示例：

获取 competitor.com 的 SEO 指标

返回内容：

域名评级（DR，0-100）
月度有机流量估算
外链总数
有机关键词数量
引用域数量
Ahrefs 排名
流量价值（美元）

数据来源： RapidAPI SEO 指标

`discoverDomainBacklinks`

发现任意域名的外链。返回详细的外链数据，支持过滤选项。

参数：

domain（必需）：要查找外链的目标域名
mode（可选）：搜索模式 - domain（默认）或 url
dofollow（可选）：仅过滤 dofollow 链接
minDR（可选）：最低域名评级（0-100）
anchorText（可选）：按锚文本过滤（部分匹配）
limit（可选）：最大结果数（1-500，默认：100）

消耗： 10 积分/次

示例：

查找所有指向 competitor.com 的 DR > 50 的 dofollow 外链

每条外链返回：

来源 URL 和域名
目标 URL
锚文本
Dofollow 状态
来源域名的 DR
首次发现/最后发现日期

数据来源： DataForSEO Backlinks API

网页抓取（需消耗积分）

`scrapeWebPage`

使用 Firecrawl 抓取网页内容，返回结构化数据（markdown、HTML、元数据）。

参数：

url（必需）：要抓取的网页 URL
formats（可选）：输出格式数组，默认 ["markdown"]。可选：markdown、html、rawHtml、links、screenshot、screenshot@fullPage
onlyMainContent（可选）：是否只返回主要内容（排除导航、页脚等），默认 true
includeTags（可选）：要包含的 HTML 标签（如 ["article", "main"]）
excludeTags（可选）：要排除的 HTML 标签（如 ["nav", "footer"]）
waitFor（可选）：等待动态内容加载的毫秒数（0-30000）
timeout（可选）：请求超时毫秒数（1000-60000），默认 30000

消耗： 2 积分/次

示例：

抓取 https://example.com/blog/article 的内容，以 markdown 格式返回

返回内容：

markdown：页面内容的 markdown 格式
html：清理后的 HTML 内容
rawHtml：原始 HTML 内容
links：页面上发现的链接数组
screenshot：截图的 base64 编码（如果请求）
metadata：页面元数据（标题、描述、OG 标签、语言等）
creditCost：消耗的积分
creditBalance：剩余积分余额

使用场景：

提取竞品页面内容进行分析
收集内容研究所需的信息
从产品页面或目录收集数据
解析博客文章或文档作为参考

数据来源： Firecrawl API

使用场景

日常 SEO 工作流

问你的 AI 助手：

生成所有项目的状态报告，包含外链数量

外链审计

检查我 SaaS 项目的所有待处理外链，列出需要关注的

发现机会

找一些 DR 在 40-60 之间的网站，我可以在那里发客座文章

批量操作

为我的项目添加这些外链：
1. https://reddit.com/r/startups/my-post - 锚文本: "startup tools"
2. https://hackernews.com/item/123 - 锚文本: "new SaaS tool"

构建资源库

添加这些外链资源到我的数据库：
1. indiehackers.com - 论坛类型, DR 70, 免费
2. producthunt.com - 目录类型, DR 90, 免费
3. betalist.com - 目录类型, DR 60, 免费增值

更新资源信息

更新 indiehackers.com 资源的以下信息：
- howToSubmit: "前往 /new，撰写至少 200 字的文章，选择一个群组，然后点击 Post"
- DR: 72

竞品分析

获取 competitor.com 的 DR 和外链统计数据，了解他们的 SEO 实力

外链发现

查找所有指向 example.com 的 DR > 50 的 dofollow 外链

网页抓取

抓取 producthunt.com/posts/my-competitor 的内容，以 markdown 格式返回主要内容

获取这篇文章的链接和元数据：https://techcrunch.com/startup-news

OAuth 2.0 架构

MyBacklinks MCP 服务器实现了以下 OAuth 2.0 特性：

标准合规

OAuth 2.1 配合 PKCE 增强安全性
RFC 8414 授权服务器元数据发现
RFC 7591 动态客户端注册
RFC 8707 资源指示器

OAuth 端点

端点	用途
`/.well-known/oauth-authorization-server`	元数据发现
`/.well-known/oauth-protected-resource`	资源元数据
`/api/oauth/register`	动态客户端注册
`/api/oauth/authorize`	授权端点
`/api/oauth/token`	令牌交换

安全特性

PKCE (S256)：防止授权码拦截
动态注册：无需预共享客户端密钥
令牌轮换：刷新令牌使用后轮换
受限作用域：仅请求 mcp 作用域

故障排除

认证失败

如果看到 "Incompatible auth server" 错误：

确保使用最新版本的 AI 客户端
检查 MCP URL 是否正确：https://mybacklinks.app/mcp
尝试移除并重新添加 MCP 服务器

令牌过期

你的 AI 客户端应该自动处理令牌刷新。如果问题持续：

从客户端移除 MCP 服务器
重新添加并完成 OAuth 流程

连接问题

验证服务器是否可访问：

curl https://mybacklinks.app/.well-known/oauth-authorization-server

你应该看到包含 authorization_endpoint 和 token_endpoint 的 JSON 元数据。

API 速率限制

MyBacklinks MCP 根据你的订阅级别有以下速率限制：

免费版：100 请求/小时
专业版：1,000 请求/小时
企业版：自定义限制

最佳实践

使用分页：对于大数据集，使用 cursor 和 limit 参数
选择字段：在 listProjectBacklinks 中使用 fields 参数减少响应大小
批量操作：在一次对话中组合相关的外链更新
检查状态：在操作前验证外链状态

下一步

在 mybacklinks.app 创建账户
设置你的第一个项目
使用上述配置连接你的 AI 助手
开始自动化你的外链管理！

支持

需要帮助？通过以下方式联系：

GitHub Issues：github.com/hekmon8/mybacklinks-tools/issues
邮箱：support@mybacklinks.app

祝自动化愉快！🚀

全部文章

分类

教程

MyBacklinks MCP 入门指南什么是 MCP？功能特点快速开始支持的客户端配置新增：直接使用 npm CLI Claude Code 配置 Cursor 配置 OpenAI Codex 配置移动端配置首次认证可用的 MCP 工具项目管理 listProjectsgetProject外链管理 listProjectBacklinksgetProjectBacklinkDetailupdateProjectBacklinks资源管理 listBacklinkResourcesdiscoverBacklinkOpportunitiesaddBacklinkResourceupdateBacklinkResource数据分析 getProjectAnalytics域名研究（需消耗积分）getDomainMetricsdiscoverDomainBacklinks网页抓取（需消耗积分）scrapeWebPage使用场景日常 SEO 工作流外链审计发现机会批量操作构建资源库更新资源信息竞品分析外链发现网页抓取 OAuth 2.0 架构标准合规 OAuth 端点安全特性故障排除认证失败令牌过期连接问题 API 速率限制最佳实践下一步支持

MyBacklinks MCP 入门指南：让 AI 管理你的外链

学习如何使用 MCP（模型上下文协议）将 Claude Code、Cursor 等 AI 助手连接到 MyBacklinks，实现自动化的项目和外链管理。

MyBacklinks MCP 入门指南

什么是 MCP？

功能特点

🔐 安全的 OAuth 2.0 认证 - 支持动态客户端注册和 PKCE 流程
🚀 零配置设置 - 只需添加 URL，认证自动完成
🛠️ 16 个统一工具 - 管理项目、外链、资源、数据分析、域名研究、状态查询和网页抓取
🔄 自动令牌刷新 - 无缝的会话管理
🎯 多平台支持 - Claude Code、Cursor、Codex 等

快速开始

支持的客户端

客户端	传输协议	OAuth
Claude Code	Streamable HTTP	✅ 内置
Cursor	Streamable HTTP	✅ 内置
OpenAI Codex	Streamable HTTP	✅ 内置
移动端应用	Streamable HTTP	✅ OAuth 或 API Key

配置

新增：直接使用 npm CLI

如果你更偏好终端工作流，可以直接安装已发布的 CLI：

npm install -g @mybacklinks/cli
mybacklinks login
mybacklinks status
mybacklinks list-projects
mybacklinks fetch-dr-by-domain --domain example.com

CLI 和 MCP 复用同一套后端工具面。login 同时支持 OAuth 门户流程和 --api-key。

只需将 MCP 服务器 URL 添加到客户端配置中：

Claude Code 配置

方式一：命令行（推荐）

# 添加到用户范围（所有项目可用）
claude mcp add --transport http --scope user mybacklinks https://mybacklinks.app/mcp

# 或仅添加到当前项目
claude mcp add --transport http mybacklinks https://mybacklinks.app/mcp

# 验证是否添加成功
claude mcp list

方式二：配置文件 (~/.claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

Cursor 配置

在项目中添加 .cursor/mcp.json：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

OpenAI Codex 配置

命令行：

codex mcp add mybacklinks --url https://mybacklinks.app/mcp

或配置文件 (~/.codex/mcp.toml)：

[[mcp_servers]]
name = "mybacklinks"
url = "https://mybacklinks.app/mcp"

移动端配置

想要随时随地管理你的外链？移动端 MCP 客户端支持两种认证方式：

方式一：OAuth 认证（推荐）

如果你的移动端 MCP 客户端支持 OAuth：

添加新服务器，URL 填写：https://mybacklinks.app/mcp
点击「连接」- 应用会自动处理 OAuth 认证
在手机浏览器中完成登录
返回应用，开始使用 MCP 工具！

方式二：API Key + 自定义 Header

如果你的移动端 MCP 客户端不支持 OAuth，可以使用 API Key 认证：

前往 MyBacklinks API Keys 页面
点击「创建 API Key」并复制生成的密钥
在移动端 MCP 客户端中，添加新服务器，URL 填写：https://mybacklinks.app/mcp
配置自定义 Header：
- Header 名称：Authorization
- Header 值：Bearer YOUR_API_KEY
保存并连接 - 即可开始使用 MCP 工具！

API Key 配置示例：

服务器 URL: https://mybacklinks.app/mcp
自定义 Headers:
  Authorization: Bearer mbk_xxxxxxxxxxxxxxxxxxxx

移动端使用场景：

通勤时查看项目状态
发现外链机会时快速添加
随时随地查看分析报告
实时响应外链状态变化

提示： OAuth 更安全，令牌可自动刷新和撤销。API Key 配置更简单，但请妥善保管，切勿公开分享。

首次认证

首次连接时，你的 AI 客户端会自动：

从 /.well-known/oauth-authorization-server 发现 OAuth 元数据
注册为动态客户端（RFC 7591）
打开浏览器让你登录
安全存储令牌供后续请求使用

无需手动设置——只需配置 URL 即可开始使用！

可用的 MCP 工具

连接后，你的 AI 助手可以使用以下 16 个工具：

项目管理

`listProjects`

列出所有项目及其元数据。

参数：

cursor（可选）：分页游标
limit（可选）：返回最大数量（1-50）

示例提示：

显示我的所有项目

返回内容：

项目 ID、名称、域名
状态（active/archived）
创建和更新时间

`getProject`

获取特定项目的详细信息。

参数：

projectId（可选）：项目 ID
domain（可选）：域名（如 "example.com"），可作为 projectId 的替代参数

注意：projectId 和 domain 二选一，至少提供一个。

示例：

获取我的 LoveMoney 项目详情

获取域名 lovemoney.app 的项目详情

返回内容：

项目元数据
各状态的外链数量（待提交、已提交、已收录、已拒绝）
资源数量
最后分析同步日期

外链管理

`listProjectBacklinks`

列出特定项目的所有外链。

参数：

projectId（必需）：项目 ID
status（可选）：按状态过滤（pending、submitted、indexed、rejected、removed）
resourceDomain（可选）：按来源域名过滤
anchorText（可选）：按锚文本子串过滤
targetUrl（可选）：按目标页 URL 子串过滤
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）

示例：

显示我项目的所有已收录外链

`getProjectBacklinkDetail`

获取特定项目外链的详细信息。

参数：

backlinkId（必需）：项目外链 ID

示例：

显示外链 abc123 的详情

`updateProjectBacklinks`

创建或更新一个或多个项目外链。

参数：

projectId（必需）：项目 ID
backlinkId（可选）：更新时的外链 ID
resourceId（可选）：外链资源 ID（会自动从资源填充 backlinkUrl）
targetUrl（创建时必需）：目标 URL（你想要获取外链的页面）
backlinkUrl（可选）：外链所在的 URL
anchor（可选）：锚文本
status（可选）：外链状态
notes（可选）：备注
items（可选）：批量更新时传入的数组负载

示例：

为我的项目添加一个新外链：
- 目标 URL: https://myapp.com
- 外链 URL: https://producthunt.com/posts/myapp
- 锚文本: "AI 驱动的工具"
- 状态: submitted

也可以通过 CLI 执行同样的流程：

mybacklinks update-project-backlinks \
  --project-id <project-id> \
  --target-url https://myapp.com \
  --backlink-url https://producthunt.com/posts/myapp \
  --anchor "AI 驱动的工具" \
  --status submitted

资源管理

`listBacklinkResources`

列出可用的外链资源（目录、论坛等），你可以在这些网站提交你的项目。

参数：

cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：过滤条件对象：
- type：资源类型（如 "guest_post"、"directory"）
- payment：付费类型（如 "free"、"paid"）
- drMin：最低域名评级
- drMax：最高域名评级

示例：

找一些高 DR（> 50）的免费外链提交网站

`discoverBacklinkOpportunities`

发现项目的外链提交机会。返回尚未使用的外链资源，帮助你找到新的外链提交渠道。

参数：

projectId（可选）：要检查的项目 ID
domain（可选）：域名（如 "example.com"），可作为 projectId 的替代参数
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：与 listBacklinkResources 相同的过滤条件

注意：projectId 和 domain 二选一，至少提供一个。

示例：

发现我 SaaS 项目还可以提交外链的机会

查找 lovemoney.app 域名的外链提交机会

`addBacklinkResource`

新增外链资源到个人数据库。如果已存在相同域名的资源，将拒绝添加。

参数：

domain（必需）：资源域名（如 "example.com"）。协议前缀和路径会被自动移除
type（必需）：资源类型（blog、directory、forum、social、other）
submissionUrl（可选）：提交外链的完整 URL
paymentType（可选）：付费类型（free、paid、freemium）。默认：free
submissionMethod（可选）：提交方式（如 "comment"、"guest post"、"profile link"）
howToSubmit（可选）：AI Agent 提交外链的自然语言指引
dr（可选）：域名评级（0-100）
traffic（可选）：预估月流量
notes（可选）：关于此资源的备注

示例：

添加一个新的外链资源：
- 域名: indiehackers.com
- 类型: forum
- 付费: free
- DR: 70
- 备注: SaaS 创始人的好社区

错误处理： 如果域名已存在于你的数据库中，工具将返回错误码 duplicate_domain，并包含已存在资源的 ID。

`updateBacklinkResource`

更新已有的外链资源。只有提供的字段会被更新，域名不可修改。

参数：

id（必需）：要更新的资源 ID（来自 listBacklinkResources）
submissionUrl（可选）：提交外链的完整 URL
type（可选）：资源类型（blog、directory、forum、social、other）
paymentType（可选）：付费类型（free、paid、freemium）
submissionMethod（可选）：提交方式（设置为 null 可清除）
howToSubmit（可选）：AI Agent 提交外链的自然语言指引（设置为 null 可清除）
dr（可选）：域名评级 0-100（设置为 null 可清除）
traffic（可选）：预估月流量（设置为 null 可清除）
notes（可选）：备注（设置为 null 可清除）

示例：

更新 indiehackers.com 资源：
- howToSubmit: "前往 /new，撰写文章，选择适当的群组，然后点击 Post"
- DR: 72
- 备注: 最近域名增长后更新的 DR

返回内容：

更新后的完整资源对象（id、domain、type、paymentType、submissionUrl、submissionMethod、howToSubmit、dr、traffic、notes、updatedAt）

数据分析

`getProjectAnalytics`

获取项目的分析数据。

参数：

projectId（必需）：项目 ID
range（可选）：时间范围（30d 或 90d）

示例：

显示我项目过去 30 天的 SEO 分析数据

域名研究（需消耗积分）

这些工具允许你研究任意域名的 SEO 指标和外链。每次成功的 API 调用都会消耗积分。

`getDomainMetrics`

查询任意域名的 SEO 指标，包括 DR、流量、外链数量等。

参数：

domain（必需）：要查询的域名（如 "example.com"）

消耗： 1 积分/次

示例：

获取 competitor.com 的 SEO 指标

返回内容：

域名评级（DR，0-100）
月度有机流量估算
外链总数
有机关键词数量
引用域数量
Ahrefs 排名
流量价值（美元）

数据来源： RapidAPI SEO 指标

`discoverDomainBacklinks`

发现任意域名的外链。返回详细的外链数据，支持过滤选项。

参数：

domain（必需）：要查找外链的目标域名
mode（可选）：搜索模式 - domain（默认）或 url
dofollow（可选）：仅过滤 dofollow 链接
minDR（可选）：最低域名评级（0-100）
anchorText（可选）：按锚文本过滤（部分匹配）
limit（可选）：最大结果数（1-500，默认：100）

消耗： 10 积分/次

示例：

查找所有指向 competitor.com 的 DR > 50 的 dofollow 外链

每条外链返回：

来源 URL 和域名
目标 URL
锚文本
Dofollow 状态
来源域名的 DR
首次发现/最后发现日期

数据来源： DataForSEO Backlinks API

网页抓取（需消耗积分）

`scrapeWebPage`

使用 Firecrawl 抓取网页内容，返回结构化数据（markdown、HTML、元数据）。

参数：

url（必需）：要抓取的网页 URL
formats（可选）：输出格式数组，默认 ["markdown"]。可选：markdown、html、rawHtml、links、screenshot、screenshot@fullPage
onlyMainContent（可选）：是否只返回主要内容（排除导航、页脚等），默认 true
includeTags（可选）：要包含的 HTML 标签（如 ["article", "main"]）
excludeTags（可选）：要排除的 HTML 标签（如 ["nav", "footer"]）
waitFor（可选）：等待动态内容加载的毫秒数（0-30000）
timeout（可选）：请求超时毫秒数（1000-60000），默认 30000

消耗： 2 积分/次

示例：

抓取 https://example.com/blog/article 的内容，以 markdown 格式返回

返回内容：

markdown：页面内容的 markdown 格式
html：清理后的 HTML 内容
rawHtml：原始 HTML 内容
links：页面上发现的链接数组
screenshot：截图的 base64 编码（如果请求）
metadata：页面元数据（标题、描述、OG 标签、语言等）
creditCost：消耗的积分
creditBalance：剩余积分余额

使用场景：

提取竞品页面内容进行分析
收集内容研究所需的信息
从产品页面或目录收集数据
解析博客文章或文档作为参考

数据来源： Firecrawl API

使用场景

日常 SEO 工作流

问你的 AI 助手：

生成所有项目的状态报告，包含外链数量

外链审计

检查我 SaaS 项目的所有待处理外链，列出需要关注的

发现机会

找一些 DR 在 40-60 之间的网站，我可以在那里发客座文章

批量操作

为我的项目添加这些外链：
1. https://reddit.com/r/startups/my-post - 锚文本: "startup tools"
2. https://hackernews.com/item/123 - 锚文本: "new SaaS tool"

构建资源库

添加这些外链资源到我的数据库：
1. indiehackers.com - 论坛类型, DR 70, 免费
2. producthunt.com - 目录类型, DR 90, 免费
3. betalist.com - 目录类型, DR 60, 免费增值

更新资源信息

更新 indiehackers.com 资源的以下信息：
- howToSubmit: "前往 /new，撰写至少 200 字的文章，选择一个群组，然后点击 Post"
- DR: 72

竞品分析

获取 competitor.com 的 DR 和外链统计数据，了解他们的 SEO 实力

外链发现

查找所有指向 example.com 的 DR > 50 的 dofollow 外链

网页抓取

抓取 producthunt.com/posts/my-competitor 的内容，以 markdown 格式返回主要内容

获取这篇文章的链接和元数据：https://techcrunch.com/startup-news

OAuth 2.0 架构

MyBacklinks MCP 服务器实现了以下 OAuth 2.0 特性：

标准合规

OAuth 2.1 配合 PKCE 增强安全性
RFC 8414 授权服务器元数据发现
RFC 7591 动态客户端注册
RFC 8707 资源指示器

OAuth 端点

端点	用途
`/.well-known/oauth-authorization-server`	元数据发现
`/.well-known/oauth-protected-resource`	资源元数据
`/api/oauth/register`	动态客户端注册
`/api/oauth/authorize`	授权端点
`/api/oauth/token`	令牌交换

安全特性

PKCE (S256)：防止授权码拦截
动态注册：无需预共享客户端密钥
令牌轮换：刷新令牌使用后轮换
受限作用域：仅请求 mcp 作用域

故障排除

认证失败

如果看到 "Incompatible auth server" 错误：

确保使用最新版本的 AI 客户端
检查 MCP URL 是否正确：https://mybacklinks.app/mcp
尝试移除并重新添加 MCP 服务器

令牌过期

你的 AI 客户端应该自动处理令牌刷新。如果问题持续：

从客户端移除 MCP 服务器
重新添加并完成 OAuth 流程

连接问题

验证服务器是否可访问：

curl https://mybacklinks.app/.well-known/oauth-authorization-server

你应该看到包含 authorization_endpoint 和 token_endpoint 的 JSON 元数据。

API 速率限制

MyBacklinks MCP 根据你的订阅级别有以下速率限制：

免费版：100 请求/小时
专业版：1,000 请求/小时
企业版：自定义限制

最佳实践

使用分页：对于大数据集，使用 cursor 和 limit 参数
选择字段：在 listProjectBacklinks 中使用 fields 参数减少响应大小
批量操作：在一次对话中组合相关的外链更新
检查状态：在操作前验证外链状态

下一步

在 mybacklinks.app 创建账户
设置你的第一个项目
使用上述配置连接你的 AI 助手
开始自动化你的外链管理！

支持

需要帮助？通过以下方式联系：

GitHub Issues：github.com/hekmon8/mybacklinks-tools/issues
邮箱：support@mybacklinks.app

祝自动化愉快！🚀

全部文章

MyBacklinks MCP 入门指南：让 AI 管理你的外链

分类

更多文章

MyBacklinks CLI 发布：用命令行快速管理外链和 SEO 数据

用 AI Agent 自动化外链管理：OpenClaw + MyBacklinks CLI

滚雪球外链策略：如何系统化构建你的链接帝国

MyBacklinks MCP 入门指南：让 AI 管理你的外链

分类

更多文章

MyBacklinks CLI 发布：用命令行快速管理外链和 SEO 数据

用 AI Agent 自动化外链管理：OpenClaw + MyBacklinks CLI

滚雪球外链策略：如何系统化构建你的链接帝国