hidrix-tools
Enables web search via Brave Search API, providing titles, URLs, and descriptions for search results.
Enables scraping Facebook groups, pages, and keyword search via Apify.
Integrates with Meta Ad Library API to scrape Facebook ads and analyze ad strategies.
Uses Mozilla Readability to fetch any URL and convert it to clean, readable markdown.
Provides access to various third-party APIs through RapidAPI hub, including Reddit, YouTube, TikTok, and fallback for X/Twitter search.
Provides tools for searching Reddit posts, reading full threads with comment trees, and fetching top posts from any subreddit.
Offers website traffic, ranking, and engagement analytics via SimilarWeb API.
Provides local data storage and querying for scraped posts with deduplication and run history.
Enables searching TikTok videos for content analysis.
Allows searching YouTube videos for content discovery.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hidrix-toolssearch the web for latest AI developments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
What 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│
└──────────┘ └──────────────┘ └─────────┘Related MCP server: Percival Deep Research
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 |
| ✅ Tested |
Native extension (no MCP) | ✅ Tested | |
| ✅ Compatible | |
| ✅ Compatible | |
MCP settings | ✅ Compatible | |
MCP config | ✅ Compatible | |
Any MCP client | stdio transport | ✅ |
Tools
Search
Tool | Source | What it does |
| Brave Search | Search the web — titles, URLs, descriptions |
| GetXAPI / RapidAPI | Search X/Twitter with engagement data (likes, retweets, views) |
| GetXAPI | Read full X threads, articles, and tweet replies |
| GetXAPI | Get recent posts from a specific X user with engagement |
| RapidAPI | Search Reddit with full text and engagement data |
| Reddit JSON API (free) | Read full post + comment tree |
| Reddit JSON API (free) | Top posts from any subreddit by time range |
| RapidAPI | Search YouTube videos |
| RapidAPI | Search TikTok videos |
Scrape & Fetch
Tool | Source | What it does |
| Mozilla Readability | Fetch any URL → clean readable markdown |
| Apify + Meta API | Scrape FB groups, pages, keyword search, or Meta Ad Library |
Analyze
Tool | Source | What it does |
| Built-in | Score and rank posts by weighted engagement + time-decay |
| Built-in | Topic clusters, content patterns, timing trends, author leaderboard |
Tool | Source | What it does |
| Apify (no login) | Search LinkedIn posts by keyword with engagement data |
| Apify (no login) | Get recent posts from a LinkedIn profile |
Intel
Tool | Source | What it does |
| RapidAPI | Website traffic, rank, engagement analytics |
Storage & Automation
Tool | Source | What it does |
| 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 .envConnect 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 piSee integrations/pi-extension/README.md for details.
Standalone (any MCP client):
bun run server.tsAPI Keys
Tools are auto-skipped if their API keys are missing — only configure what you need.
Key | Tools | Free Tier | Get it |
| web_search | 2,000 queries/month | |
| x_search, x_thread_reader, x_user_posts | $0.001/call, no subscription | |
| x_search (fallback), reddit_search, youtube_search, tiktok_search | Varies | |
| youtube_channel (primary) | Paid from $9/mo | |
| facebook_scraper (group/page/search) | $5/month credit | |
| facebook_scraper (ads mode) | Free, unlimited |
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_nameSee 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 roadmapDocs
Doc | Description |
How to create a new tool | |
Standards for detecting and reporting issues | |
Tracked provider limitations and quirks | |
Development roadmap (X upgrade, Reddit upgrade, LinkedIn, extensions) |
Tech stack
Technology | Purpose |
Runtime | |
Language | |
Agent protocol | |
Web search | |
Content extraction | |
Facebook scraping | |
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.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sonpiaz/hidrix-tools'
If you have feedback or need assistance with the MCP directory API, please join our Discord server