内容
# Scrapely MCP 服务器
一款封装了 [Scrapely](https://scrapely.co) API 的 MCP（模型上下文协议）服务器，允许像 Claude 这样的 AI 助手直接管理您的 Twitter/X DM 外联——活动、线索抓取、对话、CRM 和预定推文——所有这些都可以通过自然语言完成。
**GitHub：** [github.com/deepblue6/scrapely-mcp](https://github.com/deepblue6/scrapely-mcp)
## 安装
```bash
npm install -g scrapely-mcp
```
或直接运行而无需安装：
```bash
npx scrapely-mcp
```
## 设置
您需要一个 Scrapely API 密钥。在您的 [Scrapely 仪表盘](https://app.scrapely.co) 的 **设置** 中生成一个。
### Claude 代码
```bash
claude mcp add scrapely -e SCRAPELY_API_KEY=sk_live_your_key_here -- npx scrapely-mcp
```
### Claude 桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"scrapely": {
"command": "npx",
"args": ["scrapely-mcp"],
"env": {
"SCRAPELY_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
### 其他 MCP 客户端
任何与 MCP 兼容的客户端都可以使用。只需使用环境中设置的 `SCRAPELY_API_KEY` 运行 `npx scrapely-mcp`。
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `list_accounts` | 列出所有连接的 Twitter/X 账户 |
| `add_account` | 添加一个新账户（cookies + 代理） |
| `remove_account` | 按 ID 或用户名删除一个账户 |
| `update_cookies` | 刷新现有账户的 cookies |
| `update_proxy` | 更新账户的代理设置 |
| `toggle_pause` | 暂停/恢复 DM 发送 |
| `toggle_followups_pause` | 暂停/恢复后续消息 |
| `get_account_tags` | 获取账户标签 |
| `set_account_tags` | 替换账户的所有标签 |
| `update_account_tags` | 添加或删除个别标签 |
| `create_scraping_source` | 使用关键词和计数过滤器抓取关注者/正在关注 |
| `check_scraping_status` | 检查抓取作业的进度 |
| `launch_campaign` | 启动带有 A/B 测试、自动关注/点赞/评论的 DM 活动 |
| `list_campaigns` | 列出活动及其统计数据 |
| `get_campaign_analytics` | 详细分析：回复率、情感、变体统计。支持日期范围过滤。 |
| `fetch_conversations` | 获取对话，可选消息历史 |
| `send_dm` | 向现有对话发送 DM |
| `get_crm_data` | 获取按 CRM 标签组织的对话 |
| `update_crm` | 更新备注、交易价值和标签 |
| `enrich_twitter` | 从姓名 + 公司查找某人的 Twitter 配置文件 |
| `enrich_email` | 从 Twitter 用户名查找某人的电子邮件 |
| `get_webhook_info` | 获取 webhook 事件类型和有效载荷结构文档 |
| `schedule_tweet` | 预定推文 |
| `list_scheduled_tweets` | 列出预定的推文及其过滤器 |
| `cancel_scheduled_tweet` | 取消待定的预定推文 |
## 示例提示
连接 Claude 后，您可以说：
- "显示我所有连接的账户"
- "抓取 @naval 和 @paulg 的关注者，筛选创始人，关注者超过 1k"
- "启动名为 Q1 Outreach 的活动，针对我的 Tech Founders 源"
- "我的活动分析如何？哪个变体表现最好？"
- "显示 1 月 1 日至 1 月 31 日的活动统计数据"
- "在 CRM 中显示所有感兴趣的回复"
- "向对话 123456-789012 发送跟进消息"
- "从我的主账户预定一条推文，时间为明天 9 点"
- "查找 Acme Corp 的 John Doe 的 Twitter 配置文件"
- "查找 @elonmusk 的电子邮件"
- "暂停备份账户的 DM 发送"
## 使用 MCP Inspector 进行测试
```bash
SCRAPELY_API_KEY=sk_live_your_key npx @modelcontextprotocol/inspector npx scrapely-mcp
```
这将打开一个浏览器 GUI，您可以在连接 Claude 之前测试每个工具。
## 要求
- Node.js 18+
- 具有 API 密钥的 Scrapely 账户
## 许可证
MIT
