46 lines
3.3 KiB
Markdown
46 lines
3.3 KiB
Markdown
|
# research-tooling (Perplexity Pack)
|
|||
|
|
|
|||
|
|
Off-phase слой веб-разведки тулчейна Лидерры — три MCP-сервера для breadth-first
|
|||
|
|
разведки на крупных/абстрактных задачах (актуальные практики, нормативные требования,
|
|||
|
|
фич-разведка конкурентов, deep-research с цитатами). Формализован как 20-я off-phase
|
|||
|
|
подкатегория `research-tooling` (Tooling §4.x #87–#89; ADR-019; границы — см. ниже).
|
|||
|
|
|
|||
|
|
## Серверы и роли
|
|||
|
|
|
|||
|
|
| # | Сервер | Пакет | Роль | Tools (ключевые) |
|
|||
|
|
|---|---|---|---|---|
|
|||
|
|
| 87 | **perplexity** | `@perplexity-ai/mcp-server` | ранжированный ответ-с-источниками + sonar | `perplexity_ask` / `perplexity_search` / `perplexity_research` / `perplexity_reason` |
|
|||
|
|
| 88 | **exa** | `exa-mcp-server` | семантическое/нейро-обнаружение (находит концептуально близкое) | `web_search_exa` / `web_fetch_exa` |
|
|||
|
|
| 89 | **firecrawl** | `firecrawl-mcp` | глубокое чтение страниц + обход + автономный research-агент | `firecrawl_scrape` / `crawl` / `extract` / `firecrawl_agent` |
|
|||
|
|
|
|||
|
|
**Разделение (anti-overlap):** perplexity — готовый ранжированный ответ; exa —
|
|||
|
|
обнаружение источников по смыслу; firecrawl — прочитать/обойти/извлечь целиком.
|
|||
|
|
Границы закреплены ADR-019.
|
|||
|
|
|
|||
|
|
## Ключи (только user env)
|
|||
|
|
|
|||
|
|
`PERPLEXITY_API_KEY` / `EXA_API_KEY` / `FIRECRAWL_API_KEY` — **только в пользовательском
|
|||
|
|
окружении**, никогда в репозиторий (gitleaks/§5.4). Платные API (sonar-*, exa, firecrawl).
|
|||
|
|
При отсутствии ключа сервер падает gracefully (как Sentry MCP), не ломая сессию.
|
|||
|
|
|
|||
|
|
## Риск bulk-load MCP-инструментов
|
|||
|
|
|
|||
|
|
+3 сервера ≈ +15 tools к общему числу MCP-инструментов. Исторически массовая загрузка
|
|||
|
|
схем всех инструментов давала API-ошибку (`tools.110/113`) и роняла субагентов в
|
|||
|
|
`subagent-driven-development` (см. `.mcp.json` нота про отключённый маркетинг 2026-05-31).
|
|||
|
|
Сейчас спасает механизм deferred-tools (схемы грузятся по запросу через ToolSearch), но при
|
|||
|
|
массовых субагент-прогонах это учитывать.
|
|||
|
|
|
|||
|
|
## Провенанс
|
|||
|
|
|
|||
|
|
Вет происхождения всех трёх пакетов (владелец/лицензия/провенанс/что исполняет) —
|
|||
|
|
[research-vet.md](research-vet.md) (IS9, 2026-06-14): все три ПРИНЯТ.
|
|||
|
|
|
|||
|
|
## Связано
|
|||
|
|
|
|||
|
|
- [research-vet.md](research-vet.md) — провенанс-вет (IS9).
|
|||
|
|
- `docs/superpowers/specs/2026-06-14-perplexity-pack-research-tooling-design-v3.md` — дизайн.
|
|||
|
|
- `.mcp.json` — блоки серверов (Plan 1 Task 3).
|
|||
|
|
- `docs/Tooling_v8_3.md` Прил. Н §4.x — реестр узлов (Plan 2).
|
|||
|
|
- `docs/routing-off-phase.md` — связка L17 research chain (Plan 3).
|