styx-search

Durchsuchen Sie 450,000+ Open-Access-Publikationen, Standards, Lehrbücher und Rechtsdokumenten — direkt aus Ihrem Terminal oder aus Ihrem KI-Agenten.

styx-search ist ein CLI und Model Context Protocol (MCP)-Server ohne Konfiguration für das Styx Open Knowledge Archive. Jede Quellle im Archiv ist Open Access or public domain – keine Paywalls, kein Konto zum Suchen erforderlich.

• Für Menschen – Suchen, BibTeX/APA/MLA/Chicago-Zatationen exportieren und PDFs mit einem Befehl auf die Festplatte herunterladen.

• Für KI-Agenten – ein stdio-MCP-Server mit vier Tools, sodass Claude, Curssor, Windsurf, OpenCode oder jederzeige MCP-Client Pabe... und PDFs in Ihrem Arbetsbereich speichern können.

• 100% in sich gechlost – kommuniziert ausschließlich mit der öffentlichen HTTPS-API. Keine API-Schlüssel, keine Anmeldung, keine ineerne Infrastrur.

Install

pip install styx-search

Oder aus dem Quellcode:

git clone https://github.com/0x923041-dotcom/styx-cli.git
cd styx-cli
pip install .

Erforderlich Python 3.8+.

Related MCP server: Crossref Academic MCP Server

Schnellstart

# Search — supports source:/lang:/category: directives
styx search "attention is all you need" --limit 5
styx search "source:nist zero trust" --category "Computer Science & Tech"
styx search "source:eurlex AI act" --json
styx search "meditations marcus aurelius" --markdown   # for Obsidian/Notion

# Download the original PDF
styx download 297465 -o paper.pdf          # by document ID
styx download "https://arxiv.org/pdf/2604.21816v1.pdf"   # by URL

# Citations
styx cite 7288 --format bibtex
styx cite 7288 --format apa

# Document metadata
styx info 2844

# License key (Pro) + quota
styx auth STYX-XXXX-XXXX-XXXX
styx quota

# AI agent server
styx mcp

Beispiel

$ styx search "source:nist zero trust" --limit 3

Styx - 3 results for "source:nist zero trust"
    #   Year  Title                                 Author                 Source
    1   n.d.  NIST SP 1800-35: Implementing a Zero  Scott Rose (NIST); ..  NIST
              Trust Architecture: High...
    2   n.d.  NIST SP 800-207: Zero Trust           Scott Rose (NIST); ..  NIST
              Architecture
    3   n.d.  NIST SP 800-207A: A Zero Trust        Ramaswamy Chandramo..  NIST
              Architecture Model for Access ...

  Tip: styx download 2844 saves the PDF, styx cite 2844 exports a citation.

Suchdirektiven

Das CLI versteht dieselben Direktiven wie the Styx web app – sie werden aus der Anfräge entferht und als chete Filters angewendet:

Direktiven lassen sich frei kombinieren:styx-search "cat:\\"Computer Science & Tech\\" source:nist lattice cryptography".

Model Context Protocol (MCP)

Der Befel styx mcp startet eine stdio-JSON-RPC-MCP-Server. Er ist abhängigkeitesfei (kein MCP-SDK erforderlich) und funktioniert mit jedem belieigem MCP-CClient.

Tools

Claude Desktop

Fügen Sie claude_desktop_config.json hinzu:

• macOS: ~/Library/Application Support/Claude/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Cursor

Settings → Cursor Settings → MCP → Add new MCP server:

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

Nach dem Hinzufügen starten Sie den Client neu und können z. B. fragen:

"Finde den NIST-Post-Quanten-Encryption-Standard und lade das PDF in meinen Arbeitsbereich herunter."

Manueller Smeke-Test

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | styx mcp

Faire Nutzung

Jeithle Eingellen im Styx-Archiv sind offen Zugang oder gemeinfrei, und das Suchen ist kostenlos. Damit das Archiv für für alle offen bleibt, gilt je Client ein Testkontatrix (und danach ein Ratenlimit). Wenn ein Limit erreicht ist, gibt das CLI eine klare, nicht blockierende Meldung zurück:

Free trial allowance exhausted. Add a license key to continue at higher
limits: docs at https://styx-iota.vercel.app or `styx auth <key>`.

Fügen Sie einmalig über styx auth <key> einen Lizenzschlüssel hinzu – er wird in ~/.styx/config.json gespeichert and mit jeder Anfrage mitgesendet. Kein Konto und keine Anmeldung ist erforderlich, um zu suchen.

Entwicklung

pip install -e . pytest
pytest tests/            # 36 offline tests (mocked HTTP, no network)

Lizenz

MIT — siehe LICENSE.

Badelt auf dem Styx Open Knowledge Archive – 500+ live Quellen: arXiv, NIST, OWASP, CISA, PubMed TakamiC, MIT OpenCourseware, EUR-Lex, Project Gutenberg und mehr.