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

pip install jiro-sdk

from jiro_sdk import JiroClient

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

# Search
results = client.search("python web scraping")

# Scrape
content = client.scrape("https://example.com")

# AI Research
answer = client.ai_ask("What is Python?")

# Parallel Search
results = client.search_parallel("AI news", num_engines=3)

# Batch Operations
job = client.batch_search(["python", "javascript", "go"])

npm install jiro-sdk

import { JiroClient } from 'jiro-sdk';

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

// Search
const results = await client.search('python web scraping');

// Scrape
const content = await client.scrape('https://example.com');

// AI Research
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 get github.com/DevAnimecx/jiro/sdk/go

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

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

// Search
results, _ := client.Search("python web scraping", nil)

// Scrape
content, _ := client.Scrape("https://example.com", nil)

// AI Research
answer, _ := client.AiAsk("What is Python?", nil)

# 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-...

# Benchmark
jiro bench --iterations 5

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

# Basic search
curl -X POST http://localhost:8000/search \
  -H "Content-Type: application/json" \
  -d '{"q": "python web scraping", "engine": "google", "num": 10}'

# Parallel search
curl "http://localhost:8000/search.json?q=AI+news&parallel=true&num_engines=3"

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

// Real-time search results
const ws = new WebSocket('ws://localhost:8000/ws/search?query=AI+news');
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data);
};

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

# Ask a research question
curl -X POST http://localhost:8000/ai/search \
  -H "Content-Type: application/json" \
  -d '{"query": "Compare React vs Vue", "max_sources": 5}'

# Batch search
curl -X POST http://localhost:8000/batch/search \
  -H "Content-Type: application/json" \
  -d '{"queries": ["python", "javascript", "go"], "num_results": 5}'

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

# Prometheus metrics
curl http://localhost:8000/metrics

# Health check
curl http://localhost:8000/health

# System status
jiro status

docker-compose up -d

helm install jiro ./helm/jiro

pip install jirosearch
jiro serve --host 0.0.0.0 --port 8000

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
├── db.py             SQLite/PostgreSQL
└── dashboard.py      Web UI

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Run linter
ruff check jiro/