使用说明
关键字洞察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_idlist_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页”
- “为美国制作一份英文版的‘最佳跑鞋’内容简报”
- “撰写一篇关于‘可持续园艺技巧’的文章”
许可证
麻省理工学院
