Jiro Search API 🔍

Local-First, KI-native Websuch- & Scraping-API — ein Drop-in-Ersatz, eine selbst gehostete SerpAPI-Alternative mit MCP-Server, agentischer Recherche und integrierter rechtlicher Compliance.

Jiro durchsucht Google, Bing, DuckDuckGo, Brave, YouTube, Amazon, eBay, Yandex und Baidu direkt — ohne Such-API von Drittanbietern, ohne Abrechnung pro Anfrage, ohne Cloud-Lock-in. Ergebnisse werden lokal in SQLite gecacht (gecachte Antworten in unter 50 ms) und über eine SerpAPI-kompatible REST-API bereitgestellt. Die API ist darauf ausgelegt, von KI-Agenten aufgerufen zu werden: Function-Calling-Schemata für OpenAI/Anthropic/Gemini, ein Model Context Protocol (MCP)-Server, LangChain-/LlamaIndex-Wrapper sowie eine agentische /ai/search-Schleife, die plant → sucht → Seiten liest → eine mit Quellen belegte Antwort synthetisiert. Bring your own Keys (BYOK) für Proxys, CAPTCHA-Löser und LLM-Anbieter.

Status: Produktionsreifes MVP (Open Source, MIT). Hoste es selbst für 0 $ oder abonniere Jiro Cloud für eine verwaltete Proxy-Flotte, SLA und Compliance-Dashboard. Verantwortungsvoller Einsatz: Suchmaschinen wehren sich aktiv gegen Bots. Von Residential-IPs (und mit BYOK-Proxys) funktionieren Google/DuckDuckGo; auf Rechenzentrums-IPs wechselt Jiro automatisch über die Engines hinweg (google → bing → brave → duckduckgo). Respektiere die ToS jeder Engine und robots.txt.

Warum Jiro? (Selbst gehostete SerpAPI-Alternative)

Related MCP server: websearch-skill

Start mit einem Befehl

pip install jiro-search          # or: uv tool install jiro-search

jiro serve                       # API on http://localhost:8000  (docs: /docs)

Das ist alles — eine funktionierende selbst gehostete Such-API in einem Befehl.

# Search (SerpAPI-compatible endpoint)
curl "http://localhost:8000/search.json?engine=google&q=python+web+scraping&num=5"

# Scrape a page into clean markdown
curl -X POST http://localhost:8000/scrape \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"markdown"}'

# Agentic research with citations
curl -X POST http://localhost:8000/ai/search \
  -H "Content-Type: application/json" \
  -d '{"query":"What is the best Python web scraping library in 2026?","max_sources":5}'

Feature-Matrix

Was du bekommst

Jiro vs. SerpAPI, ScraperAPI & Bright Data

Jiro ist in der Lage, **Open-Source- ** Selbst zu hosten, die Suche + Scraping + agentics Research + MCP in einem Binary verbindet, mit eingebauter Legal-Compliance. Preislich sind SerpAPI/ScraperAPI/Bright Data teurer (meist 3 kostenpflichtig) als Jiro's eigene Kosten. Kündigungs-Komplorens: Mögliche $1.900/Monat für Nutzung dieser Funktionen und lassen dich nie selbst hosten.

Fakten: Jiro kombiniert in einer Macht GNP1 – (Funktionsumfang) ist reicher als SerpAPI/ScraperAPI und „Witze in Bezug auf MCP-Research“**modern.

→ vollständige Vergleiche: vs SerpAPI · vs ScraperAPI · vs Bright Data

KI-Agenten-Integration

Model Context Protocol (MCP)

Jiro enthält einen vollwertigen MCP-Server (stdio, StreamHelper HTTP, Legacy-SSE) — genug für AI Agenten, PDF- oder Set-verwandte Software.

jiro mcp                           # MCP server over stdio
jiro mcp --transport http         # Streamable HTTP + SSE on :8000/mcp

Tools: search (10 Engines, 6 Suchtypen) · scrape (Markdown/Text/HTML/JSON) · ai_search (agentische Recherche mit Quellen).
Prompts: search_and_summarize, compare_engines. Autocomplete: Engine-Kamen, Diese-Tippe, Such-Typen, Sort.

Claude Desktop

{
  "mcpServers": {
    "jiro": {
      "command": "jiro",
      "args": ["mcp"],
      "env": { "JIRO_CONFIG": "~/.jiro/config.yaml" }
    }
  }
}

Cursor / Continue.dev / Zed / Clayton

We rät, den MCP-Client auf den Server-Befehl jiro mcp zu zeigen (see docs/mcp).

Function Calling (OpenAI / Anthropic / Gemini)

from jiro.ai.tools import openai_tools, anthropic_tools, gemini_tools
tools = openai_tools()           # OpenAI / OpenRouter / Ollama

LangChain / LlamaIndex

from jiro.ai.tools import langchain_tools, ToolSpec
tools = langchain_tools(search_fn=my_search, scrape_fn=my_scrape, ai_fn=my_ai_search)

→ Tutorial: Baue einen tiefgelickten Recherche-Agent mit Jiro + Claude (MCP)

API-Referenz

Interaktive Dokumentation unter http://localhost:8000/docs (Swagger-UI) und http://localhost:8000/openapi.json.

REST-API

Authentifizierung: X-API-Key: jsk_...-Header, ?api_key=...-Parameter oder Authorization: Bearer <jwt>. Bei auth.enabled: false ist die API offen und für lokale Nutzung geeignet.

CLI

jiro serve                        # start the API server
jiro search web "python scraping" --engine bing --num 5 --json
jiro scrape "https://example.com" --format markdown
jiro ask "best python scraping library?" --max-sources 5
jiro mcp                          # MCP server over stdio
jiro config init                  # write ~/.jiro/config.yaml
jiro config show
jiro keys create --name "ci" --role user        # prompts for admin key
jiro keys list
jiro keys revoke key_abc123
jiro usage --days 7
jiro plugins create myengine --author "Your Name"   # scaffold a new engine

Konfiguration & BYOK

Konfigurationsdatei unter ~/.jiro/config.yaml (oder $JIRO_CONFIG). Einzelne Schlüssel via Env: JIRO_SERVER__PORT=9000, JIRO_AUTH__ENABLED=true; um API_Key: ${GITHUB_TOKEN} zu interpolieren, setze API_Key entsprechend.

Deployment

Docker

docker compose up -d            # http://localhost:8000

Helm (Kubernetes)

helm install jiro ./helm \
  --set config.env.JIRO_AUTH__ENABLED=true \
  --set config.envFromSecret=jiro-secrets

Enthält Deployment, Service, PVC (SQLite-Daten), optionales Ingress und optionalen Redis-Cache (--set redis.enabled=true).

Team-Einrichtung (Auth aktiviert)

export JIRO_AUTH__ENABLED=true JIRO_JWT_SECRET=$(openssl rand -hex 32)
jiro keys create --name admin --role admin --admin-key "$ADMIN"
jiro keys create --name "alice" --role user --rate-limit 30

💡 Open Core & Monetarisierung

Jiro ist Open Source (MIT) und wird immer kostenlos selbst gehostet werden können. Das nachhaltige Modell:

Wir monetarisieren Komfort, Compliance und Support — niemals den Code. Community-Beiträge bleiben MIT.

→ Roadmap: docs/ROADMAP.md

Dokumentation

• 📖 Dokumentations-Hub

• 🔌 MCP-Integration

• ⚖️ Compliance & verantwortungsvolle Nutzung

• 🆚 vs. SerpAPI · vs. ScraperAPI · vs. Bright Data

• 🎓 Deep-Research-Agent-Tutorial

Performance

Projektstruktur

jiro/
├── ai/            LLM providers, tool schemas, agentic loop (research + multi-step agent + SSE)
├── scraping/      HTTP client (UA rotation, retries, circuit breaker, proxy manager, browser fallback),
│                  engines: google/bing/brave/duckduckgo/youtube/amazon/ebay/yandex/baidu
├── server/        FastAPI app: routers (search, scrape, ai, stream, jobs, admin, ops, system)
├── auth.py        API keys (SHA-256 hashed), JWT, rate limiting
├── browser.py     Playwright browser fallback (lazy, graceful degradation)
├── cache.py       SQLite / memory cache manager
├── captcha.py     BYOK CAPTCHA solvers (2Captcha, CapSolver)
├── config.py      YAML + env config with ${VAR} interpolation
├── db.py          SQLite (WAL): cache, api_keys, usage, jobs, semantic_cache, tos_acknowledgments
├── extract.py     readability + metadata + HTML→Markdown
├── jobs.py        async job queue + webhooks (HMAC-signed)
├── mcp.py         MCP server (stdio): tools, prompts, resources, autocompletion
├── models.py      Pydantic contracts
├── proxy.py       BYOK proxy manager (provider presets, rotation, cooldown)
├── recipes.py     CSS / XPath / JSONPath extraction recipes
├── redis_cache.py Redis cache backend
├── semantic.py    embedding-based semantic cache
└── cli.py         Typer CLI
tests/             parser fixtures + unit/API/integration/chaos/property tests

Entwicklung

git clone https://github.com/DevAnimecx/jiro.git && cd jiro
pip install -e ".[dev,browser,redis,recipes]"
pytest -m "not network"            # skip network-dependent tests
jiro serve --reload

Roadmap-Status

• Phase 1 (MVP) — ✅ CLI, Konfiguration, FastAPI-Server, Google-/Bing-/DDG-Web-Engines, SerpAPI-kompatibles JSON, SQLite-Cache, API-Key-Authentifizierung, OpenAI-Tool-Schema, /ai/search, Dockerfile.

• Phase 2 — ✅ Brave + Bing-Videos, Bild-/News-Typen, Team-Keys, MCP-Server, LangChain/LlamaIndex-Wrapper, Batch-Scraping, /metrics, Playwright-Fallback, BYOK-Proxy + CAPTCHA, SSE, Redis.

• Phase 3 — ✅ /ai/agent für mehrstufige Recherche, CSS-/XPath-/JSONPath-Rezepte, LLM-Extraktion, Plugin-Registry, asynchrone Jobs + Webhooks.

• Phase 4 — Teilweise: semantischer Cache enthalten; RAG-Pipelines, horizontale Skalierung und der Marktplatz für Parser der Community bleiben zukünftige Arbeit. Helm-Chart bereitgestellt.

Definition & System Use

MIT. Jiro ist ein Scraping-Tool: Respektiere die Nutzungsbedingungen jeder Suchmaschine und robots.txt, halte die Anfrageraten moderat und nutze Proxy-/CAPTCHA-Dienste nach eigenem Ermessen. Der gesamte Datenverkehr stammt aus deinem Netzwerk; Suchanfragen sind nur für die Engines sichtbar, die du abfragst.

Community & Support

• 💬 GitHub Discussions – Fragen & Streamen

• 🐛 Issues – Fehler & funktionswünsche

• 📜 Beiträge sicherheit · Sicherheit · Code of Conduct

• 🐦 Verfolge den Start: @DevAnimecx

Entwickelt von Mortimer · Blackvault to Lokal-first, KI-native durch Suche & Scraping — kostenlos, offen und von dir selbst zu hosten.