perplexity-search

What This Skill Does

The perplexity-search skill enables your OpenClaw agent to perform real-time, high-accuracy web searches using the power of Perplexity’s API. Unlike standard web search tools that might provide noisy or outdated information, this skill delivers ranked, highly relevant, and context-aware results. It is designed for tasks where information precision and recency are paramount, such as market research, trending topics, or verifying technical documentation. The tool supports advanced filtering, allowing you to narrow down results by recency (day, week, month, year) or specify the desired number of results, ensuring the data returned fits your specific use case perfectly. It returns structured metadata, including article titles, URLs, and concise snippets, making it an ideal choice for agents that need to parse web information programmatically.

Installation

To integrate this tool into your environment, follow these steps:

1. Run the installation command: clawhub install openclaw/skills/skills/m4vf14/perplexity-search-skill
2. Obtain an API key from https://perplexity.ai/account/api.
3. Configure your key by adding it to your ~/.openclaw/openclaw.json file under the skills object as an environment variable named PERPLEXITY_API_KEY. This keeps your credentials secure and avoids hardcoding them into your scripts. Alternatively, you can export it in your shell environment.

Use Cases

• Market Research: Quickly identify industry trends or analyze competitor strategies by pulling the latest data across the web.
• Content Aggregation: Gather snippets and URLs for research projects or automated reporting pipelines.
• Real-time News: Stay informed on fast-moving topics like AI regulations or stock market shifts where daily or weekly updates are required.
• Technical Verification: Cross-reference documentation or find the latest library releases when default search providers fail to provide current context.

Example Prompts

1. "Find the latest updates on AI regulation changes from the past week and summarize the impact on small businesses."
2. "Perform a market analysis on current trends in golf coaching technology and provide 10 top-ranked results."
3. "Search for recent benchmarks for Llama 3 compared to GPT-4o and return the findings as a JSON object."

Tips & Limitations

• Rate Limiting: Be mindful of your Perplexity plan’s usage limits. Since this uses the Perplexity API, requests are charged per usage. Monitor your status at the Perplexity dashboard.
• Recency Filtering: Use the --recency flag judiciously. Setting it to day is excellent for breaking news, while year is better for broad, evergreen research.
• Output Format: Use the --json flag if you intend to pipe this output into another OpenClaw skill, such as a summary or data processing tool, to avoid manual parsing.