perplexity-search
Search 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.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- perplexity-search
- metadata
- { "openclaw": { "emoji": "🔍", "requires": { "env": [ "PERPLEXITY_API_KEY" ] }, "primaryEnv": "PERPLEXITY_API_KEY" } }
- description
- Search 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.
03 SKILL.md 正文
Perplexity Search
Search the web using Perplexity's Search API for ranked, real-time results.
Quick Start
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" --json
API Key Setup
The 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
Parameters
query- Search query string (required)--count N- Number of results (1-10, default: 5)--recency FILTER- Recency filter:day,week,month, oryear--json- Output raw JSON instead of formatted results
Response Format
The 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"
}
Use Cases
Market Research:
python3 {baseDir}/scripts/search.py "golf coaching Instagram trends" --count 10
Recent News:
python3 {baseDir}/scripts/search.py "AI regulation updates" --recency week
Competitive Analysis:
python3 {baseDir}/scripts/search.py "AI golf training apps" --count 10
Pricing
Perplexity Search API: $5 per 1,000 requests
Track your usage at: https://perplexity.ai/account/api
Security
- API key loaded from environment only - never hardcoded
- Output sanitization prevents terminal injection
- Error messages don't expose sensitive information
- 30-second timeout prevents hanging requests
- Input validation on all parameters
Notes
- Results are ranked by relevance
- Includes real-time web data
- Supports filtering by recency
- Returns structured JSON or formatted text
- Rate limits apply based on your Perplexity plan
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.