perplexity-tools

Execute Perplexity AI queries via a unified Python CLI.

2|Updated Aug 25, 2025
One-click install
npx skills add https://github.com/bsamiee/Parametric_Forge --skill perplexity-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perplexity-tools
Source: https://github.com/bsamiee/Parametric_Forge/tree/main/.claude/skills/perplexity-tools
Command: npx skills add https://github.com/bsamiee/Parametric_Forge --skill perplexity-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Executes Perplexity AI queries via a unified Python CLI. Use for web research, citation-backed questions, deep reasoning, and knowledge expansion.

Core Features & Use Cases

  • Quick questions with citations (ask) and deep research (research).
  • Reasoning tasks (reason) and web search (search) with configurable limits.
  • Centralized error handling and JSON output for downstream automation.

Quick Start

Run a quick question: perplexity-tools ask --query "What is Effect-TS?"

Frequently Asked Questions about perplexity-tools

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

FAQPage Schema
How do I get web-backed answers with citations from a CLI?

Web research via CLI retrieves citation-backed answers by querying Perplexity AI. Run `perplexity-tools ask --query "your question"` with a valid PERPLEXITY_API_KEY to receive fast, sourced results in JSON format for automation.

Can I use Perplexity API for deep research and reasoning tasks?

Perplexity API supports deep research via the `research` command and complex reasoning with the `reason` command. Both execute through the unified CLI and return structured, citation-backed outputs suitable for knowledge expansion and analytical workflows.

What's the setup required to run Perplexity CLI queries?

Set up a PERPLEXITY_API_KEY environment variable and install the httpx dependency. The CLI accepts POST requests to Perplexity's endpoint and supports commands—ask, research, reason, search—each requiring a `--query` parameter and optional flags for output control.

How do I integrate web search results into automated workflows?

Execute web search via `perplexity-tools search --query` with configurable result limits. JSON output enables downstream parsing and automation, making it suitable for feeding research data into reports, analysis pipelines, or knowledge bases.

Does Perplexity CLI work for fact-checking and verification?

The ask and research commands retrieve sourced information from web queries, supporting fact-checking use cases. Built-in citation backing and centralized error handling ensure reliable verification workflows with traceable references.

What are the constraints when querying Perplexity API at scale?

Rate limits depend on your PERPLEXITY_API_KEY tier and request frequency. Configure result limits per query and monitor JSON responses for errors; the CLI handles errors centrally but volume scaling requires managing API quota and request batching.