Frase SEO

@frase/mcp-server

关于此仓库 — Frase MCP 服务的公开主页：文档、注册表元数据（server.json）、更新日志和连接器设置。该服务在 Frase 私有单体仓库中开发，并以 @frase/mcp-server 的形式发布到 npm；托管的远程服务（OAuth）运行于 https://next.frase.io/api/mcp。欢迎在此提交问题和功能请求。

使用 Claude 与你的 Frase 账户交互。此 MCP（模型上下文协议）服务将 Frase 的 API 封装为工具，供 Claude 用于协助你进行 SEO/GEO 内容创作、研究、优化、AI 可见度跟踪等。兼容 Claude Desktop 和 Claude Code。

什么是 MCP？

模型上下文协议（MCP）是一项开放标准，允许 Claude 等 AI 助手安全地连接外部工具和数据源。此服务实现了 MCP，让 Claude 能够访问你的 Frase 账户。

托管远程服务（OAuth）

想要免设置使用？Frase 在 https://next.frase.io/api/mcp 提供托管的 MCP 服务（支持 OAuth 的流式 HTTP）。支持远程 MCP 服务的客户端可通过 URL 连接，并在浏览器中使用你的 Frase 账户登录。无需 API 密钥，无需本地安装，且会自动更新。

• Claude.ai / Claude Desktop： 打开 Frase 官方连接器，并连接你的 Frase 账户。
• Claude Code：

claude mcp add --transport http frase https://next.frase.io/api/mcp

以下选项会使用 API 密钥，通过 stdio 在本地运行服务。

快速开始

Claude Code：Claude Code（CLI）

只需一条命令，即可将 Frase MCP 服务添加到 Claude Code：

claude mcp add frase -- npx -y @frase/mcp-server --api-key sk_live_your_api_key_here

Claude Code 会在需要时自动启动服务。

手动设置（npx，高级）

1. 获取 API 密钥

从 Frase 设置获取 API 密钥。

2. 配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

3. 重启 Claude Desktop

保存配置后，重启 Claude Desktop。你应该会在 MCP 服务列表中看到“frase”。

Cursor

添加到项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

选项 E：Windsurf

添加到 Windsurf MCP 配置（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

选项 F：使用 GitHub Copilot 的 VS Code

添加到 VS Code 设置（.vscode/settings.json）：

{
  "github.copilot.chat.mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

可用工具

站点

• list_sites - 列出账户中的所有站点
• create_site - 创建要跟踪的新站点

内容简报

• list_briefs - 列出内容简报，可选按状态筛选
• create_brief - 创建新的内容简报（可选自动生成大纲）
• get_brief - 获取简报详情，包括大纲和 SERP 数据
• get_brief_status - 查看简报生成进度
• export_brief - 以 JSON 或 Markdown 格式导出简报

内容

• list_content - 列出内容条目，可选按状态筛选
• get_content - 获取内容详情，包括完整正文
• generate_content - 根据内容简报生成内容
• update_content - 更新内容标题、正文、状态或元标签
• delete_content - 删除内容条目（软删除）
• get_content_status - 查看内容生成进度
• export_content - 以 JSON、HTML 或 Markdown 格式导出内容
• regenerate_content - 根据可选指示重新生成或改进内容
• generate_hero_image - 为现有文章生成并附加 AI 主视觉图片，无需重新生成文章
• rescore_content - 重新计算内容的 SEO、GEO 和 EEAT 评分

研究

• list_research - 列出研究会话
• start_research - 开始针对某个主题的新 AI 研究（类型：topic、competitor、gap、serp）
• get_research - 获取包含发现和来源的研究详情
• delete_research - 删除研究会话
• export_research - 以 JSON 或 Markdown 格式导出研究发现

作业

• get_job_status - 检查异步作业的状态（简报、研究、审计、内容等）

审计

• list_audits - 列出网站审计
• start_audit - 开始新的网站审计（全面、技术、内容或快速）
• get_audit - 获取包含页面和问题的审计详情
• export_audit - 以 JSON 或 CSV 格式导出审计数据
• audit_page - 审计单个页面 URL 的 E-E-A-T、GEO 和 SEO 评分

SERP 分析

• analyze_serp - 分析某个查询的搜索引擎结果
• analyze_competitors - 分析某个查询的竞争对手内容
• get_search_intent - 获取某个查询的搜索意图分类

AI 可见度

• get_ai_visibility - 获取 AI 可见度概览指标
• list_prompts - 列出受监控的 AI 提示词
• create_prompt - 创建新的受监控提示词。若未指定位置，默认使用网站所在国家/地区（传入 site_id）；同一网站只能跟踪一次相同提示词。
• get_prompt - 获取包含引用和结果的提示词详情
• update_prompt - 更新受监控的提示词
• get_competitors - 获取 AI 可见度竞争对手
• get_alerts - 获取 AI 可见度警报
• get_insights - 获取 AI 可见度洞察和建议
• get_crawler_logs - 查看 AI 机器人在你的网站上的抓取活动

分析

• get_gsc_overview - 获取 Google Search Console 概览指标
• get_gsc_queries - 获取 GSC 中排名靠前的搜索查询
• get_gsc_pages - 获取 GSC 中表现最佳的页面
• get_content_gaps - 获取内容差距机会
• list_performance_alerts - 列出效果警报（流量下降、排名变化）
• resolve_alert - 将效果警报标记为已解决

优化

• list_optimizations - 列出优化会话
• start_optimization - 开始内容优化分析
• get_optimization - 获取包含建议的优化详情
• apply_optimization - 应用优化建议
• get_optimization_insights - 获取跨内容的优化洞察
• dismiss_optimization - 忽略一项优化

Webhook

• list_webhooks - 列出已配置的 Webhook

Webhook 管理仅列在托管远程服务上 — write_webhook（创建/更新）、get_webhook 和 delete_webhook。如果客户端按名称调用它们，它们仍可通过 stdio 运行；只有列表方式不同。 如果想让 Agent 发现这些 Webhook，请连接到托管端点。

CMS 发布

• publish_content - 将内容发布到 Frase CMS 或已连接的平台
• list_cms_connections - 列出网站的 CMS 连接状态

对话示例

列出你的网站

You: What sites do I have connected?
Claude: [Uses list_sites tool]

Here are your connected sites:

| ID | Name | Domain | GSC | Created |
|----|------|--------|-----|---------|
| site_abc | Main Blog | example.com | Yes | Jan 15, 2024 |
| site_def | Product Site | product.example.com | No | Feb 20, 2024 |

根据研究创建简报

You: Create a brief about React performance optimization
Claude: [Runs start_research, waits for completion, then uses create_brief with the research_session_id]

## Brief Created

- **ID:** brief_abc123
- **Topic:** React performance optimization
- **Status:** pending

**Outline generation started.** Let me check the status...

[Uses get_job_status]

The outline is ready! Let me get the details...

[Uses get_brief]

## Brief: React performance optimization

### Outline
- Introduction to React Performance
- Common Performance Bottlenecks
- Optimization Techniques
- Measuring Performance
- ...

研究某个主题

You: Research best practices for Next.js SEO
Claude: [Uses start_research]

## Research Started

- **ID:** res_xyz789
- **Query:** best practices for Next.js SEO
- **Type:** topic
- **Status:** pending

I'll check on the progress...

MCP 资源

在 Claude 中直接浏览你的 Frase 数据：

• frase://sites - 列出所有网站
• frase://sites/{id} - 查看单个网站的详情
• frase://content - 列出所有内容条目
• frase://content/{id} - 查看包含完整正文的内容
• frase://briefs - 列出所有简报
• frase://briefs/{id} - 查看包含大纲的简报

MCP 提示词

适用于常见 SEO 任务的预构建工作流：

提示词	描述
create_seo_article	完整工作流：研究、简报、大纲、内容生成
optimize_content	分析内容并应用优化建议
keyword_research	研究关键词、分析 SERP，并发掘内容机会
competitor_analysis	分析竞争对手的内容并找出差距
content_audit	执行网站审计并确定改进事项的优先级
content_pipeline	完整的自主内容生命周期：研究、简报、撰写、优化、发布
content_watchdog	监控效果、修复排名下滑，并重新优化表现不佳的内容

配置

变量	必需	描述
FRASE_API_KEY	是	你的 Frase API 密钥
FRASE_API_URL	否	覆盖 API URL（默认值：https://next.frase.io/api/v1）

故障排除

Claude Desktop 中未显示服务

1. 确认配置文件的位置：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 检查 JSON 语法；如有需要，请使用验证器

3. 完全重启 Claude Desktop（退出后重新打开）

Claude Code 中服务无法正常工作

1. 确认服务已注册：claude mcp list
2. 检查服务状态：claude mcp status frase
3. 如有需要，请移除并重新添加：claude mcp remove frase

身份验证错误

• 确认 API 密钥正确
• 确保密钥尚未过期
• 检查密钥是否具有所需权限

速率限制

服务会在触发速率限制时采用指数退避进行重试，以解决短时间内每分钟的突发请求。

以下三种限制分别独立生效：每分钟突发限制、持续的每小时上限，以及每月请求额度。重试仅对第一种限制有帮助——对于每小时上限，429 响应会包含最长一小时的 Retry-After，提前重试不会成功。请检查错误 code 以区分不同情况：rate_limit_exceeded（突发限制，稍后重试）、hourly_limit_exceeded（等待 Retry-After 指定的时间）、monthly_budget_exceeded（升级套餐或等待额度周期重置）。

支持

• Frase 文档
• API 文档
• GitHub 问题
• 电子邮件：[email protected]

隐私政策

Frase 隐私政策

此服务会连接到你的 Frase 账户，并将你发出的请求发送到 Frase API。除下文所述的工具调用遥测数据外，它不会收集任何自身数据，也不会读取你的对话历史、文件或记忆。

• 收集的内容 — 每次工具调用都会收集：你的 Frase 组织 ID 和用户 ID（或 API 密钥 ID）、工具名称、参数的 SHA-256 哈希值（不包括参数本身）、参数大小（字节）、调用耗时、调用是否成功、调用失败时的错误类型，以及时间戳。这些数据用于审计和确保可靠性。
• 不收集的内容 — 对话内容、提示词，或任何可读形式的参数值。
• 存储和保留 — 遥测数据会关联到你的 Frase 组织进行存储，并按照上述隐私政策中的保留条款予以保留。
• 与第三方共享 — 除隐私政策中列出的子处理方外，不会与其他第三方共享。
• 删除 — 请发送电子邮件至 [email protected]，申请删除你的数据。

许可证

MIT