perplexity-search

Searches the web via the Perplexity API with citations and export options.

4|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/katilevina/starry --skill perplexity-search-katilevina
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perplexity-search
Source: https://github.com/katilevina/starry/tree/main/.claude/skills/perplexity
Command: npx skills add https://github.com/katilevina/starry --skill perplexity-search-katilevina

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @perplexity-ai/perplexity_ai, dotenv, yargs, and includes scripts (resource) components.

What problem does it solve?

Web researchers and developers often need fast, trustworthy web search results with verifiable sources. This skill provides AI-grounded results from the Perplexity API, along with citations, enabling quicker research and validation.

Core Features & Use Cases

  • Search API powered web results with optional domain filters and recency controls.
  • Chat API for AI explanations and summaries with citations.
  • Export formats: Markdown, JSON, and CSV for easy integration into reports and pipelines.
  • Use case: research topics, competitive analysis, and knowledge gathering with auditable sources.

Quick Start

Install dependencies, configure the PERPLEXITY_API_KEY in the .env file under scripts, and run the perplexity.sh script with a query to perform a search.

Frequently Asked Questions about perplexity-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get AI web search results with citations using Node?

AI web search results with citations are generated by calling the Perplexity Search API via Node. The tool authenticates with an API key and handles up to 20 results per query with robust error handling.

Can I filter web search results by domain and recency using the Perplexity API?

Domain filtering and recency controls are supported when querying the Perplexity API. This enables targeted research by restricting sources to specific domains and limiting results to recent timeframes.

How do I export web search results to CSV or JSON for reporting?

Exporting web search results to Markdown, JSON, or CSV is supported directly via the CLI script. This allows easy integration of AI-grounded search data into reports and data pipelines.

Do I need a Perplexity API key to run AI-grounded searches from the command line?

A Perplexity API key is required to authenticate and run AI-grounded searches from the command line. You must configure the PERPLEXITY_API_KEY in the .env file under the scripts directory before execution.

What is the difference between the Perplexity Search API and Chat API for research?

The Search API returns web results with optional filters, while the Chat API provides AI explanations and summaries with citations. Both return auditable sources for knowledge gathering and competitive analysis.