Perplexity Search Skill

通过 scripts/search.py 调用 Perplexity Search API 进行实时网页搜索，返回标题、URL、摘要、日期等结果，支持 --count（1-10）与 --recency（day/week/month/year）过滤，可输出格式化文本或原始 JSON；需配置 PERPLEXITY_API_KEY 环境变量。

m4vf14

热度 74.83

最近更新 2026-05-11 15:53:42

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 市场分析

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add perplexity-search-skill

Metadata

name: perplexity-search
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.
metadata: {"openclaw":{"emoji":"🔍","requires":{"env":["PERPLEXITY_API_KEY"]},"primaryEnv":"PERPLEXITY_API_KEY"}}

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, or year
--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