JinDaGe - alsoasked-mcp MCP Details

article

README

🚀 AlsoAsked MCP 服务器

这是一个适用于 AlsoAsked API 的模型上下文协议（MCP）服务器，它能为 SEO 研究和内容优化提供谷歌“相关搜索问题”（People Also Ask）的数据访问服务。

✨ 主要特性

搜索相关搜索问题：获取任意搜索词的分层 PAA 数据。
账户管理：查看 API 积分和账户状态。
灵活的搜索选项：可配置语言、地区、深度和新鲜度。
丰富的数据结构：结果经过格式化，包含问题层级和数量统计。

📦 安装指南

1. 安装依赖项

npm install

2. 构建项目

npm run build

3. 获取 AlsoAsked API 密钥

注册 AlsoAsked Pro 账户。
从仪表盘生成 API 密钥。
妥善保管你的 API 密钥。

4. 添加到 Claude 配置

将以下内容添加到你的 Claude claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "alsoasked": {
      "command": "node",
      "args": ["/path/to/your/alsoasked-mcp/dist/index.js"],
      "env": {
        "ALSOASKED_API_KEY": "your-api-key-here"
      }
    }
  }
}

5. 重启 Claude 桌面应用

重启 Claude 桌面应用以加载新的 MCP 服务器。

💻 使用示例

基础用法

服务器提供了三个主要工具：

search_people_also_ask

可完全控制参数来搜索 PAA 问题：

// 示例：搜索墨西哥市场西班牙语的营销问题
{
  "terms": ["digital marketing", "content strategy"],
  "language": "es",
  "region": "mx", 
  "depth": 3,
  "fresh": true
}

search_single_term

方便进行单术语搜索：

// 示例：快速搜索单个术语
{
  "term": "machine learning",
  "depth": 2
}

get_account_info

查看账户状态和剩余积分：

// 无需参数
{}

📚 详细文档

API 参数

| 参数 | 类型 | 默认值 | 描述 | |------|------|--------|------| | terms | string[] | 必需 | 要查询的搜索词 | | language | string | "en" | 语言代码（如 en、es、fr 等） | | region | string | "us" | 地区代码（如 us、uk、ca 等） | | depth | number | 2 | 问题层级深度（1 - 3） | | fresh | boolean | false | 获取新鲜结果而非缓存结果 | | async | boolean | false | 异步处理 |

响应格式

服务器返回的结构化数据包含：

问题层级：嵌套的问题及层级。
搜索元数据：问题总数、搜索词。
账户信息：剩余积分、套餐详情。
格式化输出：简洁的 JSON 结构，便于解析。

示例查询

向 Claude 提问：

"使用 AlsoAsked 查找 '可持续能源' 相关搜索问题，深度为 3" "获取英国市场 '家庭健身器材' 的 SEO 关键词研究的 PAA 数据" "查看我的 AlsoAsked 账户积分和使用情况"

🔧 技术细节

# 开发模式下的监听模式
npm run dev

# 生产环境构建
npm run build

# 启动服务器
npm start

alsoasked-mcp