Skip to main content
Jiro

Jiro — The Search Intelligence Platform

One API. 9 search engines. 12 social platforms. AI-powered. Free forever.

PyPI version Python License: MIT Docker Downloads

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

Search Intelligence

  • Hybrid Search — keyword + semantic + freshness
  • Multi-Query — parallel query expansion
  • Answer Synthesis — extractive answers from results
  • Search Filters — domain, time range, category
  • Highlights — query-aware snippet extraction

Social Scraping (12 Platforms)

  • Reddit, Twitter/X, YouTube, LinkedIn
  • TikTok, Instagram, Facebook, Threads
  • Hacker News, Bluesky, Telegram, Pinterest

AI-Powered

  • Smart Search — intent-aware auto-routing
  • Structured Extraction — JSON schema-based data extraction
  • AI Research — agentic search with citations (Enterprise)
  • Intent Classification — 16 intent types

Enterprise Ready

  • Tenant Management — multi-tenant isolation
  • SOC2 Compliance — audit logging, data residency
  • SLA Monitoring — p50/p95/p99 latency tracking
  • Webhooks & Batch Jobs — event-driven automation

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

Get Enterprise →


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


License

MIT License — use freely, commercially, or privately.


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jirosearch-0.2.15.tar.gz (397.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jirosearch-0.2.15-py3-none-any.whl (401.7 kB view details)

Uploaded Python 3

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

Hashes for jirosearch-0.2.15.tar.gz
Algorithm Hash digest
SHA256 3e74fd0aa28bf3c1fa46858646c57ac96a4188c0322fc73afb647d32305e4d6d
MD5 e67102f627f5a0be7b0dbd791aa83463
BLAKE2b-256 badc010e467765c13b95cf8833e235436579b34d65144b7acf1494f99215c88e

See more details on using hashes here.

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

Hashes for jirosearch-0.2.15-py3-none-any.whl
Algorithm Hash digest
SHA256 450013fd2ce9a8ee19c559bf2a69ae343b210d92605d55cae01c6df7b57859f9
MD5 8331a43d38b4651d3057a9be4d2cd818
BLAKE2b-256 86b6de7dc2c478bed4173da046131c19a295a6ab845679b5e67af8945b7611bd

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.15 This release

2 files

0.2.12

2 files

0.2.11

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.2

2 files

0.1.2

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page