seo-mcp-server

# SEO MCP 使用指南 ## 快速开始 ### 安装配置 1. **构建项目** ```bash cd seo-mcp npm install npm run build ``` 2. **MCP客户端配置** ```json { "mcpServers": { "seo-mcp": { "command": "node", "args": ["/path/to/seo-mcp/dist/index.js"] } } } ``` ## 完整工作流程 ### 场景：为WINNER12写SEO文章 **用户指令**: "请以【WINNER12白皮书】和【区块链技术】【数字资产】写一篇关于WINNER12的SEO文章，语言【中文】" #### 步骤1: 生成SEO标题 ```json { "name": "generate_seo_titles", "arguments": { "main_keyword": "WINNER12白皮书", "sub_keywords": ["区块链技术", "数字资产"], "language": "zh-CN", "search_intent": "informational", "count": 10 } } ``` **输出示例**: ```json { "status": "success", "template_version": "1.0.0", "titles": [ { "title": "WINNER12白皮书：终极区块链技术指南", "character_count": 20, "ctr_score": 95, "search_intent": "informational", "structure_type": "列表式" } ], "recommendations": [ "主关键词已优化到标题前置位置", "前3个标题具有最高CTR潜力，建议优先测试" ], "next_action": "call_generate_seo_content_guide_with_selected_title" } ``` #### 步骤2: 生成内容创作指导 ```json { "name": "generate_seo_content_guide", "arguments": { "title": "WINNER12白皮书：终极区块链技术指南", "main_keyword": "WINNER12白皮书", "sub_keywords": ["区块链技术", "数字资产"], "language": "zh-CN", "word_count": 2000 } } ``` **输出示例**: ```json { "status": "success", "template_version": "1.0.0", "content_guide": { "structure": [ "引言：问题提出与解决方案预览 (200字)", "WINNER12白皮书基础概念解析 (400字)", "区块链技术的核心策略 (500字)", "数字资产实操指南 (500字)", "案例分析：成功实践解读 (300字)", "常见误区与避坑指南 (200字)", "实操检查清单与总结 (100字)" ], "keyword_placement": { "title": "包含主关键词WINNER12白皮书", "first_paragraph": "前100字内出现主关键词2次" }, "anti_ai_tips": [ "采用问题-解决方案-案例混合结构", "插入第一人称团队经历增加真实感" ] }, "seo_checklist": [ "✓ 主关键词WINNER12白皮书出现36次", "✓ 副关键词每300字出现1次" ], "next_action": "create_article_based_on_content_guide" } ``` #### 步骤3: 根据指导创作文章 AGENT根据content_guide中的结构、关键词布局和写作指导，创作最终的SEO文章。 ## 高级功能 ### 1. 版本管理 **查看版本信息**: ```json { "name": "get_template_info", "arguments": {} } ``` **切换模版版本**: ```json { "name": "set_template_version", "arguments": { "version": "v1.0.0" } } ``` ### 2. 多语言支持 **英文SEO**: ```json { "name": "generate_seo_titles", "arguments": { "main_keyword": "WINNER12 Whitepaper", "sub_keywords": ["blockchain technology", "digital assets"], "language": "en-US" } } ``` ### 3. 自定义参数 **调整字数和搜索意图**: ```json { "name": "generate_seo_content_guide", "arguments": { "title": "标题", "main_keyword": "主关键词", "sub_keywords": ["副关键词"], "language": "zh-CN", "word_count": 3000, "lsi_keywords": ["相关词1", "相关词2"], "include_data_sources": true } } ``` ## 错误处理 ### 常见错误及解决方案 1. **模版版本不存在** ```json { "status": "error", "message": "切换模版版本失败: 无法加载模版版本 v2.0.0", "available_versions": ["v1.0.0"] } ``` **解决**: 使用`get_template_info`查看可用版本 2. **参数缺失** ```json { "error": "Missing required parameter: main_keyword" } ``` **解决**: 检查必需参数是否完整 3. **语言不支持** ```json { "error": "Unsupported language: ja-JP" } ``` **解决**: 使用支持的语言代码（zh-CN, en-US） ## 性能优化 ### 1. 批量处理 ```javascript // 同时生成多个标题变体 const requests = [ { main_keyword: "关键词1", sub_keywords: ["副词1"] }, { main_keyword: "关键词2", sub_keywords: ["副词2"] } ]; ``` ### 2. 缓存策略 - 模版文件首次加载后缓存在内存 - 相同参数的请求可以复用结果 - 建议在生产环境中使用固定版本 ### 3. 资源管理 - 单个MCP进程可以处理多个并发请求 - 模版文件大小控制在合理范围内 - 定期清理不使用的版本文件 ## 集成示例 ### 与搜索MCP结合使用 ```javascript // 1. 先搜索相关素材 const searchResult = await callMCP("trudecide-hotnews", "search_trending_news", { topic: "WINNER12 区块链", limit: 5 }); // 2. 生成SEO标题 const titleResult = await callMCP("seo-mcp", "generate_seo_titles", { main_keyword: "WINNER12白皮书", sub_keywords: ["区块链技术", "数字资产"], language: "zh-CN" }); // 3. 生成内容指导 const contentGuide = await callMCP("seo-mcp", "generate_seo_content_guide", { title: titleResult.titles[0].title, main_keyword: "WINNER12白皮书", sub_keywords: ["区块链技术", "数字资产"], language: "zh-CN" }); // 4. 创作最终文章 const article = createArticle(contentGuide, searchResult); ``` ## 最佳实践 ### 1. 关键词选择 - **主关键词**: 选择搜索量适中、竞争度合理的词 - **副关键词**: 选择与主词相关的长尾词 - **LSI关键词**: 使用语义相关的词汇增强相关性 ### 2. 标题优化 - 优先选择CTR评分最高的标题 - 考虑搜索意图匹配度 - A/B测试不同结构的标题效果 ### 3. 内容创作 - 严格按照content_guide的结构创作 - 注意关键词密度控制 - 融入反AI检测策略 - 添加真实数据和案例 ### 4. 质量检查 - 使用seo_checklist逐项检查 - 确保Flesch阅读难易度>60 - 验证关键词自然分布 - 检查内容原创性和价值 --- *"SEO不仅是技术，更是艺术。好的工具让艺术创作变得更加精准和高效。"*