styx-search

Ищите 450,000+ открытых статей, стандартов, учебников и юридических документов — прямо из вашего терминала или вашего ИИ-агента.

styx-search — это CLI без настройки и сервер Model Context Protocol (MCP) для Styx Open Knowledge Archive. Каждый источник в архиве имеет открытый доступ или находится в общественном достоянии — без платных подписок, без необходимости аккаунта для поиска.

• Для людей — поиск, экспорт цитат BibTeX/APA/MLA/Chicago и скачивание PDF на диск одной командой.

• Для ИИ-агентов — stdio MCP-сервер с четырьмя инструментами, поэтому Claude, Cursor, Windsurf, OpenCode или любой MCP-клиент могут искать статьи и сохранять PDF в рабочее пространство.

• Полностью автономен — взаимодействоет только с публичным HTTPS API. Без API-ключей, без регистрации, без внутренней инфраструктуры.

Установка

pip install styx-search

Или из исходов:

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

Требуется Python 3.8+.

Related MCP server: Crossref Academic MCP Server

Быстрый старт

# 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

Пример

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

Директиви поиска

CLI понимает те же директиви, что и веб-приложение Styx, — they are taken out of the request and applied as real filters:

Директиви можно сотьев: styx search "cat:\"Computer Science & Tech\" source:nist "истая криптography".

Model Context Protocol (MCP)

Команда styx mcp запускает собственный JSON-RPC MCP-сервер. Он не требует зависимостей (MCP SDK не нужено) и работает с люболю MCP-клиентом.

Инструменты

Claude Desktop

Добавьте в claude_desktop_config.json:

• макоC: ~/Library/App Support/Claude/claude_desktop_config.json

• Windows: %APPDAT%\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"]
    }
  }
}

После добавления перезапустите клиент и can, for:

"Найдите стандарт NIST постквантово шифрован and PDF в my working ang."

Ручной смоук-тест

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

Добсто совестное использвание

Все сources in Stx are open доступа or common access, and search is free. Чтобы архив оставался открытым для всех, для каждого клиентa ustановлен пробный лимит (а затем лимит на частоту запросов). При достижении лимита CLI возвращает понятное, не блокиующее сообщение:

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

Добаавьте лицензионный ключ один раз через styx auth <key> — он хранится в ~/.styx/config.json и отправляется с каждым запросом. Для поска не нужен аккаунт или регистрация.

Разработка

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

Лицензия

MIT — см. LICENSE.

Стелитирова на базе Styx Open Knowledge Archive — 500+ постyang sources: arXiv, NIST, OWASP, CIISA, PubMed/PMC, IT OpenCourseWare, EUR-Lex, Project Gutenbacrite etc.