Setup & Installation
openclaw skills install @m4vf14/perplexity-search-skill
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install perplexity-search-skill
What This Skill Does
Runs web searches via Perplexity's Search API and returns ranked, real-time results with titles, URLs, and snippets. Supports recency filtering by day, week, month, or year. Output can be formatted text or raw JSON.
Unlike static knowledge bases, it returns live web results with publication dates, making it reliable for time-sensitive queries.
When to use it
- Finding recent news on a specific topic
- Researching competitors in a market
- Tracking trending topics from the past week
- Gathering structured web data for a report
- Searching for current pricing or product info
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: find recent news about AI regulation from the past week
AGENT
- 1Calls search.py with query 'AI regulation updates' and --recency week
- 2Perplexity API returns ranked results with titles, URLs, snippets, and dates
- 3Agent parses the JSON response
- 4Agent formats and presents the top results to the user
OUTPUT
A ranked list of recent articles on AI regulation with titles, URLs, and excerpts
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
PERPLEXITY_API_KEY environment variable (obtain at https://perplexity.ai/account/api)Perplexity API account (paid usage at $5 per 1,000 requests)