Hidrix Tools

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│
└──────────┘                     └──────────────┘                └─────────┘

Why use hidrix-tools?

Compatible agents

Tools

Search

Scrape & Fetch

Analyze

LinkedIn

Intel

Storage & Automation

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.

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

Tech stack

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.