hidrix-tools MCP server
Commit Sep 12, 2026Enables AI agents to search the web, scrape social media platforms, and analyze online content across multiple services.
Also known as sonpiaz/hidrix-tools
- Stars
- 42
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Sep 12, 2026
- License
- MIT
What is hidrix-tools MCP?
hidrix-tools enables AI agents to search the web, scrape social media platforms, and analyze online content across multiple services. It exposes 17 tools, such as web_search, x_search, x_thread_reader.
Summary generated from the project's README
About hidrix-tools MCP server
Providing AI agents with real-time internet access is what hidrix-tools enables for developers using clients like Claude, Cursor, or OpenClaw. This MCP server allows agents to move beyond local file reading by performing web searches, scraping social media, and analyzing online content. It functions via stdio transport and can be integrated into various environments by configuring settings files or using native extensions.
Users can deploy specific tools for deep research across platforms including X, Reddit, Facebook, YouTube, TikTok, and LinkedIn. The server includes specialized capabilities such as the facebook_scraper for monitoring groups and Meta Ad Library, and the content_scorer for ranking posts based on engagement. It also features a built-in SQLite data_store to save and query scraped information. To use all features, developers must provide API keys for services like Brave Search, GetXAPI, Apify, or RapidAPI, though tools are automatically skipped if keys are missing.
What you can do with it
- 1Cross-platform trend researchAn agent can find the top posts about a specific topic on Reddit and compare them with trending discussions on X.
- 2Social media engagement analysisA developer can instruct an agent to scrape Facebook groups to identify and rank the most engaging posts.
- 3Competitive advertising intelligenceAn agent can investigate the messaging strategies and active advertisements used by a competitor on Facebook.
- 4Automated article summarizationAn agent can fetch the content of multiple web URLs and extract key insights from them.
Written from the project's README. Every use case is checked against a quote from it.
hidrix-tools MCP tools 17
Detected from the READMEweb_searchx_searchx_thread_readerx_user_postsreddit_searchreddit_thread_readerreddit_subreddit_topyoutube_searchtiktok_searchweb_fetchfacebook_scrapercontent_scorer
| web_search | — | |
| x_search | — | |
| x_thread_reader | — | |
| x_user_posts | — | |
| reddit_search | — | |
| reddit_thread_reader | — | |
| reddit_subreddit_top | — | |
| youtube_search | — | |
| tiktok_search | — | |
| web_fetch | — | |
| facebook_scraper | — | |
| content_scorer | — |
Show all 17 toolsShow fewer tools
content_analyzerlinkedin_searchlinkedin_profilesimilarwebdata_store
| content_analyzer | — | |
| linkedin_search | — | |
| linkedin_profile | — | |
| similarweb | — | |
| data_store | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesonpiaz/hidrix-tools is public and reachablegithub.com/sonpiaz/hidrix-tools ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-12github.com/sonpiaz/hidrix-tools ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWhat is hidrix-tools?
AI agents like Claude, OpenClaw, Hermes, Cursor, and pi can read files and write code — but they can't search the web, read social media, or scrape data on their own.
hidrix-tools fixes that. It's an MCP server that provides tools for web search, social media search, Facebook scraping, content analysis, and more. Plug it into any agent that supports MCP — no vendor lock-in.
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│
└──────────┘ └──────────────┘ └─────────┘
Why use hidrix-tools?
| Without hidrix-tools | With hidrix-tools |
|---|---|
| Agent can only read local files | Agent can search web, read articles, scrape social media |
| "I don't have access to the internet" | "Here are the top 10 Reddit posts about your topic this week" |
| Manual copy-paste research | Agent autonomously gathers data from 7+ platforms |
| No competitive intelligence | Agent scrapes competitor FB pages, analyzes engagement patterns |
| One platform at a time | Cross-platform research in a single conversation |
Compatible agents
| Agent / Platform | Setup | Status |
|---|---|---|
| Claude Code / Claude Desktop | settings.json → mcpServers |
✅ Tested |
| pi | Native extension (no MCP) | ✅ Tested |
| OpenClaw | openclaw.json → mcp_servers |
✅ Compatible |
| Hermes Agent | config.yaml → mcp_servers |
✅ Compatible |
| Cursor | MCP settings | ✅ Compatible |
| Codex CLI | MCP config | ✅ Compatible |
| Any MCP client | stdio transport | ✅ |
Tools
Search
| Tool | Source | What it does |
|---|---|---|
web_search |
Brave Search | Search the web — titles, URLs, descriptions |
x_search |
GetXAPI / RapidAPI | Search X/Twitter with engagement data (likes, retweets, views) |
x_thread_reader |
GetXAPI | Read full X threads, articles, and tweet replies |
x_user_posts |
GetXAPI | Get recent posts from a specific X user with engagement |
reddit_search |
RapidAPI | Search Reddit with full text and engagement data |
reddit_thread_reader |
Reddit JSON API (free) | Read full post + comment tree |
reddit_subreddit_top |
Reddit JSON API (free) | Top posts from any subreddit by time range |
youtube_search |
RapidAPI | Search YouTube videos |
tiktok_search |
RapidAPI | Search TikTok videos |
Scrape & Fetch
| Tool | Source | What it does |
|---|---|---|
web_fetch |
Mozilla Readability | Fetch any URL → clean readable markdown |
facebook_scraper |
Apify + Meta API | Scrape FB groups, pages, keyword search, or Meta Ad Library |
Analyze
| Tool | Source | What it does |
|---|---|---|
content_scorer |
Built-in | Score and rank posts by weighted engagement + time-decay |
content_analyzer |
Built-in | Topic clusters, content patterns, timing trends, author leaderboard |
| Tool | Source | What it does |
|---|---|---|
linkedin_search |
Apify (no login) | Search LinkedIn posts by keyword with engagement data |
linkedin_profile |
Apify (no login) | Get recent posts from a LinkedIn profile |
Intel
| Tool | Source | What it does |
|---|---|---|
similarweb |
RapidAPI | Website traffic, rank, engagement analytics |
Storage & Automation
| Tool | Source | What it does |
|---|---|---|
data_store |
SQLite (built-in) | Save/query scraped posts, dedup, run history, storage stats |
Real-world use cases
🔍 Research agent
"Find top 10 posts about AI agents on Reddit this week, compare with X/Twitter, summarize the trends"
Agent uses: reddit_search → x_search → content_analyzer
📊 Content pipeline
"Scrape 5 Facebook groups about marketing VN, rank top 100 posts by engagement, analyze patterns"
Agent uses: facebook_scraper (group mode) → content_scorer → content_analyzer
🕵️ Competitive intelligence
"What ads is competitor X running on Facebook? What's their messaging strategy?"
Agent uses: facebook_scraper (ads mode) → Meta Ad Library API (free)
📰 Article research
"Read these 5 articles and summarize the key insights"
Agent uses: web_fetch (for each URL)
📈 Market research
"What are people saying about product X across Reddit, X, and YouTube?"
Agent uses: reddit_search + x_search + youtube_search → content_analyzer
🏆 Top content discovery
"Find the most viral posts in this Facebook group this month"
Agent uses: facebook_scraper → content_scorer (sort by engagement)
Install
Quick setup
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
Connect to your agent
Claude Code — add to ~/.claude/settings.json:
{
"mcpServers": {
"hidrix-tools": {
"command": "bun",
"args": ["run", "/path/to/hidrix-tools/server.ts"]
}
}
}
OpenClaw — add to openclaw.json:
mcp_servers:
hidrix-tools:
command: "bun"
args: ["run", "/path/to/hidrix-tools/server.ts"]
Hermes Agent — add to ~/.hermes/config.yaml:
mcp_servers:
hidrix-tools:
command: "bun"
args: ["run", "/path/to/hidrix-tools/server.ts"]
pi (coding agent) — copy extension:
cp -r integrations/pi-extension ~/.pi/agent/extensions/hidrix-tools
# Then /reload in pi
See integrations/pi-extension/README.md for details.
Standalone (any MCP client):
bun run server.ts
API Keys
Tools are auto-skipped if their API keys are missing — only configure what you need.
| Key | Tools | Free Tier | Get it |
|---|---|---|---|
BRAVE_API_KEY |
web_search | 2,000 queries/month | api.search.brave.com |
GETXAPI_KEY |
x_search, x_thread_reader, x_user_posts | $0.001/call, no subscription | getxapi.com |
RAPIDAPI_KEY |
x_search (fallback), reddit_search, youtube_search, tiktok_search | Varies | rapidapi.com |
SUPADATA_API_KEY |
youtube_channel (primary) | Paid from $9/mo | supadata.ai |
APIFY_API_TOKEN |
facebook_scraper (group/page/search) | $5/month credit | console.apify.com |
META_ADS_ACCESS_TOKEN |
facebook_scraper (ads mode) | Free, unlimited | facebook.com/ads/library/api |
Add your own tool
Tools are auto-discovered — no changes to server.ts needed.
cp -r tools/_template tools/your-tool-name
# Edit tools/your-tool-name/index.ts
bun run server.ts
# [hidrix-tools] ✓ your_tool_name
See docs/adding-a-tool.md for the full guide.
Project structure
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
Docs
| Doc | Description |
|---|---|
| Adding a tool | How to create a new tool |
| Feedback & bug reporting | Standards for detecting and reporting issues |
| Known issues | Tracked provider limitations and quirks |
| Roadmap | Development roadmap (X upgrade, Reddit upgrade, LinkedIn, extensions) |
Tech stack
| Technology | Purpose |
|---|---|
| Bun | Runtime |
| TypeScript | Language |
| MCP SDK | Agent protocol |
| Brave Search | Web search |
| Mozilla Readability | Content extraction |
| Apify | Facebook scraping |
| Meta Ad Library API | Ad intelligence (free) |
Contributing
Contributions are welcome. See CONTRIBUTING.md for guidelines.
When reporting bugs, follow docs/feedback-and-bug-reporting.md.
Related
- affiliate-skills — 45 AI agent skills
- content-pipeline — AI-powered LinkedIn content generation
- Kapt — macOS screenshot tool with annotation & OCR
- Yap — Push-to-talk dictation for macOS
License
MIT — see LICENSE for details.
hidrix-tools MCP questions
What tools does hidrix-tools MCP provide?
It exposes 17 tools, including web_search, x_search, x_thread_reader, x_user_posts, reddit_search.
Does it require API keys for all tools?
Tools are automatically skipped if their required API keys are missing, allowing you to configure only what you need.