| name | perplexity-pro-search |
| description | Режим Pro Search через local Sonar Pro script с `web_search_options.search_type=pro`. Использовать, когда нужен sourced answer, usage, step log и явный Pro Search mode. |
| compatibility | {"runtimes":["codex","claude_code","cursor","windsurf"]} |
| metadata | {"category":"research","capability_taxonomy_ids":["cap.research.web_search","cap.research.comparative_analysis"],"distribution_scope":"internal","invocation_strategy":"explicit","version":"v0.2","source_of_truth":"https://github.com/nicshik/perplexity-mcp-skills"} |
Perplexity Pro Search
Используй этот skill, когда пользователю явно нужен Perplexity Pro Search mode или когда задаче нужен короткий sourced answer по текущим источникам, а не просто список ссылок.
Skill вызывается явно, потому что Pro Search дороже Search only mode.
Preconditions
PERPLEXITY_API_KEY доступен в окружении shell, в CODEX_HOME/config.toml / ~/.codex/config.toml или в ~/.codeium/windsurf/mcp_config.json.
- Разрешен доступ к
https://api.perplexity.ai.
- Если песочница блокирует сеть, повтори тот же скрипт с повышенным доступом. Не заменяй режим другим поиском.
Non-Negotiable Rules
- Используй local script
scripts/pro_search.py.
- Сохраняй
stream=true и web_search_options.search_type="pro".
- Не переходи незаметно на Search only mode,
perplexity_ask, perplexity_reason или обычный Sonar Pro без потока.
- Используй
--json, когда Codex должен обработать результат дальше.
- Держи вопрос узким. Pro Search нужен для сравнений, сложных или зависящих от времени вопросов, а не для простых поисков.
Lean Execution Rules
- Обычно делай один вызов Pro Search API.
- Не читай
scripts/pro_search.py при обычном использовании. Открывай его только при ошибке, правке или явном вопросе пользователя.
- Не добавляй лишнюю проверку через веб, GitHub или другой API после успешного Pro Search, кроме случаев:
- пользователь явно просит независимую проверку;
- источники недостаточно официальные;
- ответ противоречив или конфликтует с официальным источником.
- Если сеть в песочнице недоступна, один раз повтори ту же команду с повышенным доступом.
- Пиши коротко: одна заметка перед запуском и одна заметка при необходимости повышенного доступа.
Default Flow
- Преврати запрос пользователя в точный вопрос.
- Добавляй фильтры только когда они реально улучшают результат:
--context-size medium|high для более широкого разбора;
--recency для свежих событий;
--domain для ограничения источников.
- Один раз запусти
scripts/pro_search.py, обычно с --json.
- Верни короткий ответ и лучшие источники.
- Показывай расход только когда это полезно или пользователь просит.
- Если ответ выглядит противоречивым или недостаточно официальным, сделай одну точечную проверку по лучшему официальному источнику.
- Если пользователю нужны только ссылки, предложи Search only mode через
$perplexity_search_only.
Recommended Commands
python3 scripts/pro_search.py "Compare the latest AI browser agent launches and explain the differences." --context-size medium --json
python3 scripts/pro_search.py "Summarize this week's official Perplexity API documentation changes." --recency week --domain docs.perplexity.ai --json
python3 scripts/pro_search.py "Which open-source MCP servers added Perplexity support in 2026?" --context-size high --json
Output Shape
- Обычный вывод: ответ, источники, расход.
--json возвращает content, search_results, usage и шаги рассуждения, если они есть.
- Если вызов API не удался, покажи ошибку напрямую. Не додумывай результат.
References
references/prompt_recipes.md