# Send Perplexity Search Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "perplexity-search-skill",
    "name": "Perplexity Search Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/M4vF14/perplexity-search-skill",
    "canonicalUrl": "https://clawhub.ai/M4vF14/perplexity-search-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/perplexity-search-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=perplexity-search-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "PUBLISHING.md",
      "README.md",
      "SECURITY_AUDIT.md",
      "SKILL.md",
      "scripts/search.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "perplexity-search-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T02:03:52.919Z",
      "expiresAt": "2026-05-14T02:03:52.919Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=perplexity-search-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=perplexity-search-skill",
        "contentDisposition": "attachment; filename=\"perplexity-search-skill-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "perplexity-search-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/perplexity-search-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/perplexity-search-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/perplexity-search-skill",
    "agentUrl": "https://openagent3.xyz/skills/perplexity-search-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/perplexity-search-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/perplexity-search-skill/agent.md"
  }
}
```
## Documentation

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: M4vF14
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T02:03:52.919Z
- Expires at: 2026-05-14T02:03:52.919Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/perplexity-search-skill)
- [Send to Agent page](https://openagent3.xyz/skills/perplexity-search-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/perplexity-search-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/perplexity-search-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/perplexity-search-skill)