内容
# 痛点探测器 MCP 服务器
直接从 Claude、Cursor 或任何 MCP 客户端查询 [痛点探测器](https://painspotter.ai) 的商业机会和每周博客分析。
痛点探测器挖掘 Reddit、Hacker News 和 Product Hunt 讨论，并使用大型语言模型来发现经过验证的商业机会，组织成三个层次：**类别**（领域）→ **主题**（具有趋势信号的集群痛点）→ **机会**（具有商业评分的具体产品创意）。**博客**发布精选机会的每周长篇分析（免费阅读，为 AI 引文而建）。
## 两种连接方式
### 远程（推荐 — 零安装）
将您的客户端指向托管端点，并将您的 API 密钥作为标头传递。在 <https://painspotter.ai/account> 创建密钥。
Claude / Cursor (`~/.cursor/mcp.json` 或 Claude 连接器)：
```json
{
"mcpServers": {
"painspotter": {
"url": "https://painspotter.ai/mcp/",
"headers": { "X-API-Key": "psk_live_your_key" }
}
}
}
```
### 本地（stdio 备用）
> 本地 stdio 包与公共 REST API 通信。它公开机会搜索和 **免费博客工具**（博客不需要密钥）。对于完整的 7 工具托管集（概览、趋势主题、主题详情），请使用上面的远程端点。
```bash
pip install painspotter-mcp # 或：uvx painspotter-mcp
```
```json
{
"mcpServers": {
"painspotter": {
"command": "uvx",
"args": ["painspotter-mcp"],
"env": {
"PAINSPOTTER_API_KEY": "psk_live_your_key",
"PAINSPOTTER_API_BASE": "https://painspotter.ai"
}
}
}
}
```
## 工具和分级
### 托管端点 (`https://painspotter.ai/mcp/`) — 7 工具
| 工具 | 分级 | 配额成本 | 描述 |
|---|---|---|---|
| `get_overview` | 免费 | 1 | 类别概览 + 趋势快照 |
| `get_opportunity` | 免费 | 1 | 一个机会的完整详情（+ 相关博客 URL，如果有） |
| `list_blog_posts` | 免费 | **0** | 最近发布的每周分析 |
| `get_blog_post` | 免费 | **0** | 一篇博客文章的完整 Markdown |
| `query_opportunities` | 专业 | 2 | 按关键词 / 分数 / 平台 / 推荐 / 类别筛选 |
| `list_trending_themes` | 专业 | 2 | 当前趋势上升的痛点 |
| `get_theme` | 专业 | 4 | 主题级市场信号 + 潜在机会 |
### 本地 stdio 包 — 4 工具
| 工具 | 密钥要求 | 描述 |
|---|---|---|
| `query_opportunities` | 是 | 筛选机会（通过 v1 API 的专业等效搜索） |
| `get_opportunity` | 是 | 完整机会详情 |
| `list_blog_posts` | **否** | 最近发布的博客文章 |
| `get_blog_post` | **否** | 一篇博客文章的完整 Markdown |
免费密钥可以调用免费托管工具；专业和商业密钥解锁所有功能。博客工具 (`list_blog_posts`, `get_blog_post`) 在托管端点上从不消耗配额。其他调用扣除密钥的每月限额（免费 20 / 专业 1000 / 商业 5000 单位）。在 <https://painspotter.ai/pricing> 升级。
## 许可证
MIT — 请参阅 [LICENSE](./LICENSE)。
