perplexity-research

name	perplexity-research
description	Web research via Perplexity Sonar API with citations. Use for live web search, fact-checking, trend analysis, best-practice lookup. Triggers: «search», «research», «fact-check», «best practices», «perplexity».

Perplexity Web Research

Веб-ресёрч через Perplexity Sonar API с цитатами.

API Key

~/.claude-lab/.secrets/perplexity.env

Загрузка: source ~/.claude-lab/.secrets/perplexity.env → переменная PERPLEXITY_API_KEY

Использование

source ~/.claude-lab/.secrets/perplexity.env

curl -s --max-time 60 "https://api.perplexity.ai/chat/completions" \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sonar-pro",
  "messages": [{"role": "user", "content": "your query here"}],
  "search_recency_filter": "month",
  "return_citations": true
}'

Модели

Модель	Для чего	Цена
sonar-pro	Глубокий ресёрч, сложные вопросы	~$3/1000 запросов
sonar	Быстрый поиск, простые вопросы	~$1/1000 запросов

Параметры

• search_recency_filter: hour, day, week, month -- фильтр свежести
• return_citations: true -- возвращает источники
• temperature: 0.0-1.0 (по умолчанию 0.2)

Парсинг ответа

import json
data = json.loads(response)
text = data['choices'][0]['message']['content']
citations = data.get('citations', [])

Когда использовать

• Актуальные данные из интернета
• Best practices, how-to
• Факт-чек утверждений
• Анализ трендов и новостей
• Сравнение технологий

Когда НЕ использовать

• Data already in your local vault / database
• Internal files / configs
• Tasks that don't require web search