Дмитрий
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).
|