Perplexity Search and Research

What it does

When your agent uses it

• Looking up fresh information on the web with cited sources
• Running a long background deep-research job and reading the report later
• Fetching the content of specific URLs without flooding the context

Example prompts

• “Search the web for recent changes to the EU battery regulation and give me the top 10 links.”
• “Use Perplexity to answer which Postgres version added incremental sort, with sources.”
• “Run a deep research report on solid-state battery startups and save it to the cache.”

Requirements

• A Perplexity API key in config/.env
• A POSIX shell and network access to the Perplexity API

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Кеш ограничен по возрасту, а не только по ключу — ключ (тело запроса)
2. 2Context window hygiene — stdout ограничен PPLX_PRINT_LIMIT (30 строк).
3. 3Правильный инструмент под задачу — сначала дешёвый search.sh
4. 4Проверяемые ответы — у каждого ответа ask.sh/research.sh в отчёте

What it can do on your machine

Read from SKILL.md and the folder at commit 8bbeead. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 10 files in scripts/ (Shell, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • sh

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • a.com
  • b.com

  Also links to:

  • docs.perplexity.ai
  • perplexity.ai

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • PERPLEXITY_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Perplexity Search and Research loads about 2.5k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 835 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~112

When it runs · the whole SKILL.md, loaded when a task matches

~2.5k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~5.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:28

  sh` копирует скилл и нормализует `config/.env` (закавычивает

• NoteMentions a .env fileSKILL.md:29

  значения с пробелами). Содержимое `.env` не выводи в ответ — при ошибках

• NoteMentions a .env fileSKILL.md:34

  Нужен `PERPLEXITY_API_KEY` в `config/.env`:

• NoteMentions a .env fileSKILL.md:37

  cp config/.env.example config/.env

• NoteMentions a .env fileSKILL.md:178

  rofile` | поиск | — | набор дефолтов из `.env` |

• NoteMentions a .env fileSKILL.md:180

  | `--model` | agent | из `.env` | `perplexity/sonar`, `openai/gpt-5.6-sol`, `anthropic/claude-sonnet-5`, … |

• NoteMentions a .env fileSKILL.md:192

  Приоритет: **флаг > `.env` > собственный дефолт скрипта**.

• NoteMentions a .env fileSKILL.md:195

  - иначе, если в `config/.env` заданы `PPLX_PRESET` / `PPLX_MODEL`, — берутся они;

• NoteMentions a .env fileSKILL.md:199

  огда не перебивает то, что вы указали в `.env`, —

• NoteMentions a .env fileSKILL.md:257

  Оффлайн, без сети и ключа: разбор `.env`, сборка тел запросов, рендер ответов из

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from artwist-polyakov/polyakov-claude-skills at commit 8bbeead, republished under its MIT licence (© artwist-polyakov). 835 words, ~2,480 tokens.

name

perplexity-search

description

Поиск и ресёрч через Perplexity API: сырая выдача (Search API), ответ с цитатами (Agent API), deep research в фоне, чтение страниц. Cache-first: крупные результаты уходят в cache/ и читаются грепом. Triggers: perplexity, перплексити, perplexity search, sonar api, найди в интернете, поищи в сети, web search, свежая информация, deep research, глубокое исследование, ответ с источниками, прочитай страницу, fetch url, что пишут про.

sh scripts/prepare_runtime.sh
cd /home/claude/perplexity-search

cp config/.env.example config/.env

# один запрос
sh scripts/search.sh --query "изменения в NDS 2026" --max-results 10

# до 5 углов темы в одном оплаченном запросе
sh scripts/search.sh \
  --query "AI regulation EU 2026" \
  --query "AI Act enforcement timeline" \
  --query "AI Act penalties companies"

# только свежее и только из нужных доменов
sh scripts/search.sh --query "postgres 19 release" --recency week \
  --domains "postgresql.org,news.ycombinator.com"

# без форумов
sh scripts/search.sh --query "лучший ноутбук для разработки" --domains "-reddit.com,-quora.com"

sh scripts/ask.sh --query "что изменилось в Claude Code за последний месяц"

# дешевле и быстрее
sh scripts/ask.sh --query "курс ЦБ на сегодня" --preset fast

# ответ строго по схеме
sh scripts/ask.sh --query "топ-5 CRM для малого бизнеса" --schema schema.json

# фоновый запуск с ожиданием
sh scripts/research.sh --query "рынок EV-зарядок в РФ: игроки, объёмы, барьеры" \
  --preset high --timeout 1800

# отправить и не ждать
sh scripts/research.sh --query "..." --no-wait
sh scripts/research.sh --resume resp_abc123

sh scripts/fetch_url.sh --url "https://example.com/pricing"
sh scripts/fetch_url.sh --url "https://a.com/post" --url "https://b.com/post" \
  --query "сравни выводы двух статей"

# что я уже спрашивал
sh scripts/find_latest.sh --script ask --match "claude"

# поиск по накопленным результатам вместо нового запроса
sh scripts/cache_grep.sh "rate limit" --type search --context 2
sh scripts/cache_grep.sh "GDPR" --files

sh scripts/<script>.sh [params]     # у каждого есть --help

cache/
├── index.tsv              # created_at, script, key, query, path — для grep
├── search/<key>.json      # сырой ответ
├── search/<key>.tsv       # таблица результатов
├── search/<key>.txt       # сниппеты целиком
├── ask/<key>.{json,md}    # ответ + источники
├── research/<key>.{json,md,id}
└── fetch/<key>.{json,md}

sh scripts/tests/run.sh

© artwist-polyakov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 29 other files (scripts, references) in plugins/perplexity-search/skills/perplexity-search of artwist-polyakov/polyakov-claude-skills.

• SKILL.md
• .gitignore
• cache/.gitkeep
• config/.env.example
• config/README.md
• references/API_REFERENCE.md
• scripts/ask.sh
• scripts/cache_grep.sh
• scripts/common.sh
• scripts/fetch_url.sh
• scripts/find_latest.sh
• scripts/prepare_runtime.sh
• scripts/research.sh
• scripts/sanitize_env.sh
• scripts/search.sh
• scripts/tests/fixtures
• … and 14 more

Open the folder on GitHubat commit 8bbeead