open-index/open-npm huggingface dataset:
npm package: @huyuan-ai/geo-scraper-mcp
Description: MCP server: 使用豆包等 AI 搜索引擎获取最新信息并返回带有引用的结构化数据
Latest version: 1.2.0

# GEO-Scraper MCP

MCP（Model Context Protocol）服务：通过豆包等 AI 搜索引擎获取最新信息并返回带有引用的结构化数据。

## 通过 npx 使用（推荐）

无需克隆仓库，直接运行：

```bash
npx -y @huyuan-ai/geo-scraper-mcp@latest
```

### 前置条件

1. **本机已启动 Chrome 并开启远程调试**  
   例如：`--remote-debugging-port=9222`。若在无界面环境（如服务器）部署，可参考 [docs/deployment.md](docs/deployment.md) 使用 Xvfb + PM2 启动 Chrome。

2. **在 Chrome 中已登录豆包**  
   在已连接 9222 端口的 Chrome 里打开 [豆包](https://www.doubao.com/chat/) 并完成扫码登录，否则抓取会被拦截。

MCP 本身无需配置 `.env` 即可运行；若你同时部署 HTTP API 服务，才需要 `SERVER_TOKEN` 等环境变量。

### 在 Cursor 中配置 MCP

在 Cursor 的 MCP 配置（如 `.cursor/mcp.json`）中加入：

```json
{
  "mcpServers": {
    "GEO-Scraper-MCP": {
      "command": "npx",
      "args": ["-y", "@huyuan-ai/geo-scraper-mcp@latest"]
    }
  }
}
```

## 本地开发

```bash
npm install
npm run build
# 启动 MCP（需本机 Chrome 已开 9222 且已登录豆包）
node bin/run.js
# 或
npm run mcp
```

部署 HTTP API 与 Chrome 的详细步骤见 [docs/deployment.md](docs/deployment.md)。

## Changelog

见 `CHANGELOG.md`。