perplexity-search-skillSearch the web using Perplexity's Search API for ranked, real-time web results with advanced filtering. Use when you need to search for current information, market research, trending topics, or when Brave Search is unavailable. Supports recency filtering (day/week/month/year) and returns structured results with titles, URLs, and snippets.
Install via ClawdBot CLI:
clawdbot install M4vF14/perplexity-search-skillSearch the web using Perplexity's Search API for ranked, real-time results.
Basic search:
python3 {baseDir}/scripts/search.py "your search query"With options:
# Get 10 results
python3 {baseDir}/scripts/search.py "AI trends 2024" --count 10
# Filter by recency
python3 {baseDir}/scripts/search.py "recent AI news" --recency week
# Get raw JSON output
python3 {baseDir}/scripts/search.py "market research" --jsonThe script requires a PERPLEXITY_API_KEY environment variable.
Option 1: Set in OpenClaw config (recommended)
Add to ~/.openclaw/openclaw.json:
{
"skills": {
"perplexity-search": {
"env": {
"PERPLEXITY_API_KEY": "your-api-key-here"
}
}
}
}Option 2: Environment variable
export PERPLEXITY_API_KEY="your-api-key-here"Get your API key from: https://perplexity.ai/account/api
query - Search query string (required)--count N - Number of results (1-10, default: 5)--recency FILTER - Recency filter: day, week, month, or year--json - Output raw JSON instead of formatted resultsThe API returns:
{
"results": [
{
"title": "Article title",
"url": "https://example.com/article",
"snippet": "Brief excerpt from the page...",
"date": "2024-01-15",
"last_updated": "2024-02-01"
}
],
"id": "search-request-id"
}Market Research:
python3 {baseDir}/scripts/search.py "golf coaching Instagram trends" --count 10Recent News:
python3 {baseDir}/scripts/search.py "AI regulation updates" --recency weekCompetitive Analysis:
python3 {baseDir}/scripts/search.py "AI golf training apps" --count 10Perplexity Search API: $5 per 1,000 requests
Track your usage at: https://perplexity.ai/account/api
Generated Mar 1, 2026
Agencies can use this skill to gather real-time data on trending topics, competitor strategies, and consumer interests. For example, searching for 'golf coaching Instagram trends' helps identify popular content and hashtags to inform social media campaigns, enabling data-driven decisions for client projects.
Startups can leverage the skill to monitor competitors by searching for terms like 'AI golf training apps' with high result counts. This provides insights into market gaps, feature comparisons, and user reviews, supporting product development and strategic positioning in fast-evolving tech sectors.
Analysts can track breaking news and regulatory updates by using recency filters, such as searching 'AI regulation updates' with a week filter. This ensures access to timely information for investment decisions, risk assessments, and reporting on market-moving events in finance and compliance.
Journalists and content creators can use the skill to source current information and verify facts for articles. Searching with recency filters like 'day' or 'week' ensures up-to-date references, while structured results simplify citation and fact-checking processes in newsrooms and publishing.
Developers can integrate this skill into custom applications or platforms to offer enhanced search capabilities. By charging subscription fees or usage-based pricing, businesses can monetize access to real-time, filtered web data for clients in sectors like market research or SaaS tools.
Consultants can use the skill to provide specialized reports and insights for clients, such as competitive intelligence or trend analysis. By packaging search results with expert analysis, they can offer high-value services, generating revenue through project-based or retainer models.
Educational institutions or e-learning platforms can incorporate the skill into courses on digital literacy, research methods, or data analysis. By offering hands-on training with real-time search capabilities, they can attract students and generate revenue through course fees or licensing.
š¬ Integration Tip
Set the PERPLEXITY_API_KEY in your OpenClaw config for seamless use, and test with basic queries before scaling to ensure compatibility with your workflow.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.