JIRO — Search API & Web Scraping Platform

9 search engines. 12 social platforms. AI-powered. Self-hosted. Free forever.

Website · Documentation · Pricing · Blog · Changelog

What is JIRO?

JIRO is an open-source, self-hosted search API and web scraping platform that aggregates results from 9 search engines and 12 social platforms. It provides AI-powered search intelligence, hybrid ranking, and stealth web scraping — all running locally on your infrastructure.

Use cases:

• Search API for AI agents and LLMs
• Web scraping at scale with anti-bot bypass
• Social media monitoring across 12 platforms
• SERP data collection for SEO tools
• Real-time web intelligence feeds
• MCP server for Claude Desktop, Cursor, and other AI tools

Quick Start

# 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"}'

You're now searching across 9 engines with hybrid ranking, caching, and structured extraction — all running locally on your machine.

Cloud API (no server needed):

# Authenticate via browser
jiro auth login

# Search with cloud API
curl -X POST https://searchjiro.vercel.app/api/proxy/search \
  -H "Authorization: Bearer jsk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"q": "latest AI research", "engine": "google"}'

Search Engines

Social Platforms

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

Official SDKs

Python

pip install jiro-sdk

from jiro_sdk import JiroClient

client = JiroClient(api_key="your-key")

results = client.search("python web scraping")
content = client.scrape("https://example.com")
answer = client.ai_ask("What is Python?")
results = client.search_parallel("AI news", num_engines=3)
job = client.batch_search(["python", "javascript", "go"])

JavaScript / TypeScript

npm install jiro-sdk

import { JiroClient } from 'jiro-sdk';

const client = new JiroClient({ apiKey: 'your-key' });

const results = await client.search('python web scraping');
const content = await client.scrape('https://example.com');
const answer = await client.aiAsk('What is Python?');

// WebSocket Streaming
const ws = client.createSearchStream('AI news');
ws.onmessage = (event) => console.log(JSON.parse(event.data));

Go

go get github.com/DevAnimecx/jiro/sdk/go

import "github.com/DevAnimecx/jiro/sdk/go"

client := jiro.NewClient(jiro.WithAPIKey("your-key"))

results, _ := client.Search("python web scraping", nil)
content, _ := client.Scrape("https://example.com", nil)
answer, _ := client.AiAsk("What is Python?", nil)

CLI Commands

# Search
jiro search web "python web scraping"
jiro search web "AI news" --parallel --engines 3
jiro search web -i  # Interactive mode

# Scrape
jiro scrape https://example.com
jiro scrape "free SaaS directories"  # Search + scrape top result

# AI
jiro ai ask "What is Python?"
jiro ai setup --provider openai -k sk-...

# Auth (Cloud)
jiro auth login       # Device code flow
jiro auth whoami      # Show account + credits
jiro auth status      # Test API key

# License (Self-Hosted)
jiro license activate JIRO-PRO-A1B2-C3D4-E5F6
jiro license info
jiro license deactivate

# System
jiro status
jiro doctor
jiro serve --port 8000

Pricing

Cloud (Managed)

Start Free → · View Pricing →

Self-Hosted (One-Time)

Install from GitHub →

MCP Integration

Works with any MCP-compatible client:

{
  "mcpServers": {
    "jiro": {
      "command": "jiro",
      "args": ["mcp"]
    }
  }
}

16 MCP Tools

Features

Search Intelligence

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

Web Scraping

• Stealth Engine — TLS/JA3 fingerprint rotation
• Anti-Bot Bypass — Cloudflare, DataDome, PerimeterX
• JavaScript Rendering — full browser automation
• Structured Extraction — JSON schema-based data extraction
• Social Scraping — 12 platforms with normalized output

AI-Powered

• Smart Search — intent-aware auto-routing
• AI Research — agentic search with citations
• Intent Classification — 16 intent types
• Self-Learning — adapts to search patterns
• Advanced Healing — automatic retry with fallback

Enterprise Ready

• Rate Limiting — sliding window with tiers
• Usage Quotas — monthly limits per tier
• Plugin System — custom engines & scrapers
• Advanced Caching — LRU/LFU with analytics
• Batch Operations — concurrent search & scrape
• Monitoring — Prometheus metrics, health checks
• WebSocket Streaming — real-time results
• MCP Integration — 16 tools for AI clients

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

Cloud

# No server needed — use cloud API
jiro auth login

Comparisons

vs SerpAPI

vs ScraperAPI

vs Bright Data

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
│   ├── client.py     Stealth engine (TLS/JA3)
│   └── social/       12 social platforms
├── ai/               AI/LLM integration
├── plugins/          Plugin system
├── monitoring.py     Metrics & health checks
├── batch.py          Batch operations
├── scheduler.py      Scheduled searches
├── history.py        Search history
├── export_import.py  Data export/import
├── ratelimit.py      Rate limiting & quotas
├── cache_advanced.py Advanced caching
├── stealth.py        Anti-bot bypass
├── mcp.py            MCP server (16 tools)
├── pro.py            Tier system
├── licensing.py      HMAC license tokens
├── secure_store.py   Encrypted credentials
├── device_auth.py    RFC 8628 device code flow
├── cloud_auth.py     Cloud authentication
├── db.py             SQLite/PostgreSQL
└── dashboard.py      Web UI

Community

• Website — Home
• GitHub — Source code
• Documentation — Guides & tutorials
• Pricing — Plans & tiers
• Blog — Articles & tutorials
• Changelog — Release notes
• Discord — Community chat
• Twitter — Updates

License

MIT License — use freely, commercially, or privately.