Keywordinsights MCP

关键字洞察MCP服务器

MCP（模型上下文协议）服务器，提供与 关键词洞察API.

特性

• 23工具 涵盖所有Keyword Insights API端点
• 使用令牌缓存进行自动身份验证
• 异步HTTP客户端实现最佳性能
• 完全支持关键字聚类、排名、内容摘要和作者代理
• 对大型结果集的分页支持
• 显式参数模式，更好地理解人工智能模型
• 紧凑的响应 -输出减少约70%（无空格、空/空）

安装

选项1：使用uvx（推荐）

无需安装-uvx在隔离环境中运行该包：

uvx keyword-insights-mcp

如果你没有安装紫外线，请从以下网址获取 星光sh/uv.

选项2：使用pip

pip install keyword-insights-mcp

注： 如果您安装了多个Python版本，请确保使用将运行服务器的相同Python进行安装。使用 python -m pip install keyword-insights-mcp 要明确。

用法

使用Claude桌面版

添加到您的Claude Desktop配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

使用uvx（推荐）

{
  "mcpServers": {
    "keyword-insights": {
      "command": "uvx",
      "args": ["keyword-insights-mcp"],
      "env": {
        "KEYWORD_INSIGHTS_EMAIL": "your-email@example.com",
        "KEYWORD_INSIGHTS_PASSWORD": "your-password"
      }
    }
  }
}

使用pip安装

{
  "mcpServers": {
    "keyword-insights": {
      "command": "python",
      "args": ["-m", "keyword_insights_mcp.server"],
      "env": {
        "KEYWORD_INSIGHTS_EMAIL": "your-email@example.com",
        "KEYWORD_INSIGHTS_PASSWORD": "your-password"
      }
    }
  }
}

使用克劳德代码

添加到您的项目 .mcp.json 或克劳德代码设置：

使用uvx（推荐）

{
  "mcpServers": {
    "keyword-insights": {
      "command": "uvx",
      "args": ["keyword-insights-mcp"],
      "env": {
        "KEYWORD_INSIGHTS_EMAIL": "your-email@example.com",
        "KEYWORD_INSIGHTS_PASSWORD": "your-password"
      }
    }
  }
}

使用pip安装

{
  "mcpServers": {
    "keyword-insights": {
      "command": "python",
      "args": ["-m", "keyword_insights_mcp.server"],
      "env": {
        "KEYWORD_INSIGHTS_EMAIL": "your-email@example.com",
        "KEYWORD_INSIGHTS_PASSWORD": "your-password"
      }
    }
  }
}

MCP检验员测试

mcp dev src/keyword_insights_mcp/server.py

可用工具

用户

• get_user -获取帐户数据、信用余额和订阅信息

关键词排名

• create_advanced_ranking_order -分析单个关键字的SERP

- 必修的： keyword, location, language - 可选： device, domain, include_word_count

• get_advanced_ranking_order -获取排名顺序结果
• create_advanced_ranking_batch_order -分析SERP中的多个关键字
• get_advanced_ranking_batch_order -获取批量排名结果

内容简介

• get_content_brief_languages -列出支持的语言
• create_content_brief -根据SERP分析创建内容简报

- 必修的： keyword, language, location

• get_content_brief -通过以下方式获取简要结果 brief_id
• list_content_briefs -列出所有简报

关键字内容

• create_keyword_content_order -提取内容见解（PAA、Reddit/Quora问题、元标题/描述）

- 必修的： keyword, language, location, content_insights - 可选： device - 学分成本：paa/reddit/quora=50学分，元标题/描述=每个200学分

• get_keyword_content_order -获取内容订单结果

关键词洞察（聚类）

• get_insights_languages -列出支持的语言
• get_insights_locations -列出位置（默认情况下返回前20个）
• search_insights_locations -按名称搜索位置（推荐）
• create_insights_order -创建关键字聚类顺序

- 必修的： project_name, keywords, search_volumes, language, location, insights - 可选： clustering_method, grouping_accuracy, hub_creation_method, device, url, folder_id - 见解选项： cluster, context, rank, title_ai

• get_insights_order -获取聚类顺序状态/结果
• get_insights_order_cost -创建前估算订单成本

- 必修的： n_keywords, insights

• get_insights_order_json -使用分页获取集群数据

- 必修的： order_id - 可选： page_size （默认值50）， page_number, sort_by, ascending

• export_insights_order_xlsx -导出到Excel文件
• list_insights_orders -按计数或日期范围列出订单

编剧代理

• get_writer_agent_options -获取可用的内容类型、音调和POV选项
• create_writer_agent_order -生成AI文章大纲、计划和内容

- 必修的： keyword - 可选： language_code, location_name, content_type, point_of_view, folder_id, additional_insights

• get_writer_agent_order -获取生成的内容结果

示例用法

配置后，您可以要求Claude：

• “获取我的Keyword Insights帐户余额”
• “搜索与‘墨西哥’匹配的地点”
• “使用聚类和上下文洞察估算500个关键字的聚类成本”
• “为这些关键字及其搜索量创建关键字洞察顺序”
• “获取订单abc123的聚类结果的第2页”
• “为美国制作一份英文版的‘最佳跑鞋’内容简报”
• “撰写一篇关于‘可持续园艺技巧’的文章”

许可证

麻省理工学院