Jiro — The Search Intelligence Platform
One API. 9 search engines. 12 social platforms. AI-powered. Free forever.
Get Started Free · Website · API Docs · Enterprise · Discord
Why Jiro?
Jiro is a local-first, AI-native search & scraping API — a self-hosted alternative to SerpAPI, ScraperAPI, and Bright Data. It gives you:
- 9 search engines — Google, Bing, Brave, DuckDuckGo, YouTube, Amazon, eBay, Yandex, Baidu
- 12 social platforms — Reddit, Twitter/X, YouTube, LinkedIn, TikTok, Instagram, and more
- Hybrid search — keyword + semantic + freshness signals combined
- AI-powered research — agentic search with citations (Enterprise)
- MCP integration — works with Claude Desktop, Cursor, Continue.dev
- Free forever — generous free tier, no credit card required
Quick Start (30 seconds)
# Install
pip install jirosearch
# Start server
jiro serve
# Search the web
curl -X POST http://localhost:8000/search \
-H "Content-Type: application/json" \
-d '{"q": "latest AI research", "engine": "google"}'
That's it. You're searching across 9 engines with hybrid ranking, caching, and structured extraction — all running locally on your machine.
Features
Free vs Enterprise
| Feature | Free | Enterprise |
|---|---|---|
| Rate Limits | 100 RPM / 10K RPD | 1,000 RPM / 1M RPD |
| Search Engines | 9 engines | 9 engines |
| Social Platforms | 12 platforms | 12 platforms |
| Hybrid Search | ✅ | ✅ |
| Smart Search | ✅ | ✅ |
| Structured Extraction | ✅ | ✅ |
| Social Batch | ✅ (5/batch) | ✅ (500/batch) |
| Self-Learning | ✅ (basic) | ✅ (advanced) |
| AI Research | ❌ | ✅ |
| Advanced Healing | ❌ | ✅ |
| Custom Models | ❌ | ✅ |
| Commercial Use | ❌ | ✅ |
| White Label | ❌ | ✅ |
| Premium Support | ❌ | ✅ |
| Price | $0 forever | $499/mo |
API Examples
Search the Web
# Basic search
curl -X POST http://localhost:8000/search \
-H "Content-Type: application/json" \
-d '{"q": "python web scraping", "engine": "google", "num": 10}'
# Hybrid search with answer synthesis
curl -X POST http://localhost:8000/search \
-H "Content-Type: application/json" \
-d '{"q": "latest AI research", "hybrid": true, "answer": true}'
Scrape Any URL
# Scrape to markdown
curl -X POST http://localhost:8000/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://docs.python.org", "format": "markdown"}'
# Batch scrape
curl -X POST http://localhost:8000/scrape/batch \
-H "Content-Type: application/json" \
-d '{"urls": ["https://example.com", "https://docs.python.org"]}'
Social Media
# Scrape a Reddit post
curl -X POST http://localhost:8000/social \
-H "Content-Type: application/json" \
-d '{"url": "https://reddit.com/r/programming/comments/abc123"}'
# Search across platforms
curl -X POST http://localhost:8000/social/search \
-H "Content-Type: application/json" \
-d '{"query": "machine learning", "platform": "reddit", "limit": 10}'
Smart Search (Auto-Routing)
# Auto-detect intent and route to best engine
curl -X POST http://localhost:8000/v1/smart \
-H "Content-Type: application/json" \
-d '{"query": "github.com/fastapi"}'
MCP Integration
Works with any MCP-compatible client:
{
"mcpServers": {
"jiro": {
"command": "jiro",
"args": ["mcp"]
}
}
}
16 MCP Tools
| Tool | Tier | Description |
|---|---|---|
search |
Free | Search 9 engines |
scrape |
Free | Scrape URL to markdown |
smart_classify |
Free | Classify search intent |
compare_engines |
Free | Compare across engines |
list_engines |
Free | List all engines |
list_social_platforms |
Free | List social platforms |
monitor_status |
Free | Health metrics |
health_check |
Free | Quick health check |
cache_stats |
Free | Cache statistics |
ai_search |
Enterprise | AI research with citations |
search_hybrid |
Enterprise | Hybrid multi-signal search |
search_structured |
Enterprise | Structured data extraction |
social_scrape |
Enterprise | Scrape social media |
social_search |
Enterprise | Search social platforms |
social_batch |
Enterprise | Batch scrape URLs |
smart_search |
Enterprise | Intent-aware routing |
Pricing
Free — $0/forever
The most generous free tier in search APIs. No credit card required.
- 100 requests/minute
- 10,000 requests/day
- 9 search engines
- 12 social platforms
- Hybrid search & smart routing
- MCP integration
- Community support
Enterprise — $499/mo
Everything in Free, plus unlimited power.
- 1,000 requests/minute
- 1,000,000 requests/day
- AI-powered agentic research
- Custom LLM models
- White-label customization
- SOC2 compliance
- Premium support
- Commercial use license
Deploy
Docker
docker-compose up -d
Kubernetes
helm install jiro ./helm/jiro
Local
pip install jirosearch
jiro serve --host 0.0.0.0 --port 8000
Comparisons
vs SerpAPI
| Feature | Jiro | SerpAPI |
|---|---|---|
| Self-hosted | ✅ | ❌ |
| Free tier | 10K RPD | 100/mo |
| Social scraping | 12 platforms | ❌ |
| Hybrid search | ✅ | ❌ |
| MCP integration | ✅ | ❌ |
| Price (paid) | $499/mo | $50/mo |
vs ScraperAPI
| Feature | Jiro | ScraperAPI |
|---|---|---|
| Search engines | 9 | ❌ |
| Social platforms | 12 | ❌ |
| AI research | ✅ | ❌ |
| Self-hosted | ✅ | ❌ |
| Free tier | 10K RPD | 5K/mo |
vs Bright Data
| Feature | Jiro | Bright Data |
|---|---|---|
| Price | $499/mo | $500+/mo |
| Self-hosted | ✅ | ❌ |
| Hybrid search | ✅ | ❌ |
| MCP integration | ✅ | ❌ |
| AI research | ✅ | ❌ |
Architecture
jiro/
├── server/ FastAPI application
│ └── routers/ API endpoints (75+ routes)
├── search/ Search intelligence
│ ├── hybrid.py Hybrid search
│ ├── reranker.py Result reranking
│ └── multiquery.py Query expansion
├── scraping/ Web scraping
│ ├── engines.py 9 search engines
│ └── social/ 12 social platforms
├── ai/ AI/LLM integration
├── mcp.py MCP server (16 tools)
├── pro.py Tier system
├── licensing.py HMAC license tokens
├── db.py SQLite/PostgreSQL
└── dashboard.py Web UI
Development
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
# Run linter
ruff check jiro/
Community
- Website — Home
- GitHub — Source code
- Discord — Community chat
- Twitter — Updates
- Documentation — Guides & tutorials
License
MIT License — use freely, commercially, or privately.
Built with ❤️ by Blackvault Technology
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jirosearch-0.2.15.tar.gz.
File metadata
- Download URL: jirosearch-0.2.15.tar.gz
- Upload date:
- Size: 397.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e74fd0aa28bf3c1fa46858646c57ac96a4188c0322fc73afb647d32305e4d6d
|
|
| MD5 |
e67102f627f5a0be7b0dbd791aa83463
|
|
| BLAKE2b-256 |
badc010e467765c13b95cf8833e235436579b34d65144b7acf1494f99215c88e
|
File details
Details for the file jirosearch-0.2.15-py3-none-any.whl.
File metadata
- Download URL: jirosearch-0.2.15-py3-none-any.whl
- Upload date:
- Size: 401.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
450013fd2ce9a8ee19c559bf2a69ae343b210d92605d55cae01c6df7b57859f9
|
|
| MD5 |
8331a43d38b4651d3057a9be4d2cd818
|
|
| BLAKE2b-256 |
86b6de7dc2c478bed4173da046131c19a295a6ab845679b5e67af8945b7611bd
|