hidrix-tools
MCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.
______________________________________________________________________
什么是hidrix工具?
像Claude、OpenClaw、Hermes、Cursor和pi这样的人工智能代理可以读取文件和编写代码,但他们不能自己搜索网络、阅读社交媒体或抓取数据。
hidrix工具修复了这个问题。 这是一个 主控程序 服务器,提供网络搜索、社交媒体搜索、脸书抓取、内容分析等工具。将其插入任何支持MCP的代理中——没有供应商锁定。
Your AI Agent hidrix-tools Internet
┌──────────┐ MCP protocol ┌──────────────┐ ┌─────────┐
│ Claude │ ◄─────────────────► │ web_search │ ◄────────────► │ Brave │
│ OpenClaw │ │ x_search │ │ X/Twitter│
│ Hermes │ │ reddit_search│ │ Reddit │
│ Cursor │ │ facebook_ │ │ Facebook│
│ pi │ │ scraper │ │ YouTube │
│ Codex │ │ content_ │ │ TikTok │
│ ... │ │ scorer │ │ Meta Ads│
└──────────┘ └──────────────┘ └─────────┘为什么要使用hidrix工具?
| 无hidrix工具 | 有hidrix工具 |
|---|---|
| Agent只能读取本地文件 | Agent可以搜索网页、阅读文章、抓取社交媒体 |
| “我无法上网” | “以下是本周Reddit上关于你主题的十大帖子” |
| 手动复制粘贴研究 | 代理自主从7+个平台收集数据 |
| 没有竞争情报 | 特工抓取竞争对手的脸书页面,分析参与模式 |
| 一次一个平台 | 一次对话中的跨平台研究 |
兼容代理
| 代理/平台 | 设置 | 状态 |
|---|---|---|
| 克劳德代码 /克劳德桌面 | settings.json → mcpServers | ✅ 已测试 |
| π | 本机扩展(无MCP) | ✅ 已测试 |
| 开爪 | openclaw.json → mcp服务器 | ✅ 兼容 |
| 赫尔墨斯代理 | config.yaml → mcp服务器 | ✅ 兼容 |
| 光标 | MCP设置 | ✅ 兼容 |
| Codex CLI | MCP配置 | ✅ 兼容 |
| 任何MCP客户端 | stdio传输 | ✅ |
工具
搜索
| 工具 | 来源 | 它的作用 |
|---|---|---|
web_search | 勇敢搜索 | 搜索网络——标题、网址、描述 |
x_search | GetXAPI/RapidAPI | 使用参与度数据(点赞、转发、浏览量)搜索X/Twitter |
x_thread_reader | GetXAPI | 阅读完整的X条帖子、文章和推特回复 |
x_user_posts | GetXAPI | 获取具有参与度的特定X用户的最新帖子 |
reddit_search | RapidAPI | 使用全文和参与度数据搜索Reddit |
reddit_thread_reader | Reddit JSON API(免费) | 阅读完整帖子+评论树 |
reddit_subreddit_top | Reddit JSON API(免费) | 按时间范围排列的任何子版块的热门帖子 |
youtube_search | RapidAPI | 搜索YouTube视频 |
tiktok_search | RapidAPI | 搜索TikTok视频 |
刮取
| 工具 | 来源 | 它的作用 |
|---|---|---|
web_fetch | Mozilla可读性 | 获取任何URL→ 清晰易读的标记 |
facebook_scraper | Apify+Meta API | 抓取FB组、页面、关键字搜索或Meta广告库 |
分析
| 工具 | 来源 | 它的作用 |
|---|---|---|
content_scorer | 内置 | 通过加权参与度+时间衰减对帖子进行评分和排名 |
content_analyzer | 内置 | 主题集群、内容模式、时间趋势、作者排行榜 |
领英
| 工具 | 来源 | 它的作用 |
|---|---|---|
linkedin_search | Apify(无需登录) | 按关键字搜索带有参与度数据的LinkedIn帖子 |
linkedin_profile | Apify(无需登录) | 从LinkedIn个人资料中获取最新帖子 |
英特尔
| 工具 | 来源 | 它的作用 |
|---|---|---|
similarweb | RapidAPI | 网站流量、排名、参与度分析 |
存储与自动化
| 工具 | 来源 | 它的作用 |
|---|---|---|
data_store | SQLite(内置) | 保存/查询抓取的帖子、数据删除、运行历史记录、存储统计数据 |
真实世界的用例
🔍 研究代理
“本周在Reddit上找到关于人工智能代理的前10篇帖子,与X/Twitter进行比较,总结趋势”
代理使用: reddit_search → x_search → content_analyzer
📊 内容管道
“删除5个关于营销VN的Facebook群组,按参与度对前100个帖子进行排名,分析模式”
代理使用: facebook_scraper (分组模式)→ content_scorer → content_analyzer
🕵️ 竞争情报
“竞争对手X在脸书上投放了哪些广告?他们的消息传递策略是什么?”
代理使用: facebook_scraper (广告模式)→ 元广告库API(免费)
📰 文章研究
“阅读这5篇文章并总结关键见解”
代理使用: web_fetch (针对每个URL)
📈 市场调研
“Reddit、X和YouTube上的人们对产品X有什么看法?”
代理使用: reddit_search + x_search + youtube_search → content_analyzer
🏆 顶级内容发现
“查找本月该Facebook群组中最热门的帖子”
代理使用: facebook_scraper → content_scorer (按约定排序)
安装
快速设置
git clone https://github.com/sonpiaz/hidrix-tools.git ~/.hidrix-tools
cd ~/.hidrix-tools && bun install && cp .env.example .env
# Add your API keys to .env连接到您的代理
克劳德代码 --添加到 ~/.claude/settings.json:
{
"mcpServers": {
"hidrix-tools": {
"command": "bun",
"args": ["run", "/path/to/hidrix-tools/server.ts"]
}
}
}开爪 --添加到 openclaw.json:
mcp_servers:
hidrix-tools:
command: "bun"
args: ["run", "/path/to/hidrix-tools/server.ts"]赫尔墨斯代理 --添加到 ~/.hermes/config.yaml:
mcp_servers:
hidrix-tools:
command: "bun"
args: ["run", "/path/to/hidrix-tools/server.ts"]pi(编码剂) --复制扩展名:
cp -r integrations/pi-extension ~/.pi/agent/extensions/hidrix-tools
# Then /reload in pi看 集成/pi扩展/README.md 了解详情。
独立 (任何MCP客户端):
bun run server.tsAPI密钥
如果工具的API密钥丢失,则会自动跳过-只配置您需要的内容。
| 关键 | 工具 | 免费等级 | 获取它 |
|---|---|---|---|
BRAVE_API_KEY | web_search | 每月2000次查询 | api.search.brave.com |
GETXAPI_KEY | x_search、x_thread_reader、x_user_posts | $0.001/调用,无订阅 | getxapi.com |
RAPIDAPI_KEY | x_search(回退)、reddit搜索、youtube搜索、tiktok搜索 | 各不相同 | 网站 rapidapi.com |
SUPADATA_API_KEY | youtube_channel(主要) | 每月9美元起支付 | 类似.ai |
APIFY_API_TOKEN | facebook_scraper(组/页/搜索) | $5/月信用 | console.apify.com |
META_ADS_ACCESS_TOKEN | facebook_scraper(广告模式) | 免费,无限制 | facebook.com/ads/library/api |
添加您自己的工具
工具是自动发现的,无需更改 server.ts 需要。
cp -r tools/_template tools/your-tool-name
# Edit tools/your-tool-name/index.ts
bun run server.ts
# [hidrix-tools] ✓ your_tool_name看 docs/adding-a-tool.md 完整的指南。
项目结构
hidrix-tools/
├── server.ts — MCP server, auto-discovers tools
├── tools/
│ ├── _template/ — Copy this to create a new tool
│ ├── web-search/ — Brave Search
│ ├── web-fetch/ — URL → markdown
│ ├── x-search/ — X/Twitter search (GetXAPI + RapidAPI fallback)
│ ├── x-thread-reader/ — Read X threads & articles
│ ├── x-user-posts/ — User timeline with engagement
│ ├── reddit-search/ — Reddit search (upgraded)
│ ├── reddit-thread-reader/ — Full post + comment tree (free API)
│ ├── reddit-subreddit-top/ — Subreddit top posts (free API)
│ ├── youtube-search/ — YouTube search
│ ├── tiktok-search/ — TikTok search
│ ├── similarweb/ — Traffic analytics
│ ├── facebook-scraper/ — FB groups, pages, search, ads
│ ├── content-scorer/ — Engagement scoring + ranking
│ └── content-analyzer/ — Topic/pattern/trend analysis
├── lib/
│ ├── tool-registry.ts — Auto-discovery engine
│ ├── rapidapi.ts — Shared RapidAPI client
│ ├── getxapi.ts — GetXAPI client (X/Twitter)
│ ├── apify.ts — Apify REST client
│ ├── meta-ads.ts — Meta Ad Library API client
│ └── readability.ts — HTML → markdown extraction
└── docs/
├── adding-a-tool.md — Tool authoring guide
├── feedback-and-bug-reporting.md — Bug reporting standards
├── known-issues.md — Tracked limitations
└── ROADMAP.md — Development roadmap文档
技术栈
| 技术 | 目的 |
|---|---|
| 包子 | 运行时间 |
| TypeScript | 语言 |
| MCP-SDK | 代理协议 |
| 勇敢的搜索 | 网络搜索 |
| Mozilla可读性 | 内容提取 |
| Apify | Facebook抓取 |
| 元广告库API | 广告情报(免费) |
贡献
欢迎捐款。看 贡献.md 作为指导方针。
报告错误时,请遵循 docs/反馈和错误报告.md.
相关
许可证
麻省理工学院——见 许可证 了解详情。
______________________________________________________________________
Built by Son Piaz
