Skip to main content
skill CX Codex

perplexity-search · dotneet — Claude Code skill: web search and research via

Adds four Perplexity API modes to your agent: quick answers, deep research, reasoning, and raw search results.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-code
Open on GitHub

What perplexity-search does

The skill wraps the Perplexity API in a single Python script, scripts/perplexity_api.py. Four modes sit inside: ask answers general questions on sonar-pro, research produces longer reports on sonar-deep-research, reason handles analysis on sonar-reasoning-pro, and search returns web results. The agent picks a mode from how you phrase the request.

search takes --max-results (1 to 20, default 10), --max-tokens-per-page (256 to 2048, default 1024) and --country with an ISO code. On research and reason you can pass --strip-thinking to drop thinking... tags and save context.

Set PERPLEXITY_API_KEY before the first call. Nothing runs without it, so check that first. Timeouts are raised through PERPLEXITY_TIMEOUT_MS (default 300000), and behind a proxy you set PERPLEXITY_PROXY or HTTPS_PROXY.

What it helps with

  • pull fresh news on a topic without opening a browser
  • collect source URLs for a write-up
  • work through a hard problem step by step
  • get a long report on a technical subject
  • get results scoped to one country

Example prompts for the agent

  • search the web for what changed in this library recently
  • do deep research on vector databases and write up a report
  • analyze this approach and tell me where it breaks

How to install perplexity-search

1Skills CLI (Vercel)

npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-code

2Manually: put the files in place

~/.claude/skills/perplexity-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/perplexity-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about perplexity-search

How do I install perplexity-search in Claude?

Run npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-code. The skill lands at ~/.claude/skills/perplexity-search/SKILL.md.

What does perplexity-search do?

It gives the agent Perplexity API access in four modes: ask, research, reason and search. Calls go through scripts/perplexity_api.py.

What does the skill need to run?

The PERPLEXITY_API_KEY environment variable and an internet connection. Behind a proxy, set PERPLEXITY_PROXY or HTTPS_PROXY.

Similar skills

All skills for Agent setup: memory, context, orchestration →

perplexity-search by other authors comes first.

From the same set3

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor