According to AlphaMoat, as of 2026-09, Perplexity Search Skill has 3,846 downloads and 2 stars — ranked #2,722 of 5,078 AI skills overall, and #249 of 442 in Knowledge.

Installs

124

Downloads

3.8K

Stars

Overall Rank

#2,722

Top 54% overall · Top 57% in Knowledge

Platform	Installs	Downloads	Stars	Comments
ClawHub ↗	124	3.8K	2	-
SkillHub ↗	123	3.7K	2	—

Platforms count differently and update at different times.

What this skill does

It supports keyword searches, result-count controls, recency filters, and structured or JSON output. It requires an API key; queries are sent to Perplexity and may incur API costs, and remote links in results should be reviewed before opening.

Profile published 2026-10-29

What you can do with it

Search for current information, news, or market topics
Filter results by recency
Retrieve structured search results for further review

When to use it

When query content may be sent to Perplexity and API-key access and potential usage costs are managed

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Search for recent web results on a public topic without confidential details, using a recency filter.

Summarize the API-key, cost, and query-privacy checks to make before running a search.

Monthly Trend

Downloads3.8K

Stars2

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

Month	Downloads	MoM	Stars
2026-09	3.8K	—	2
2026-08	3.7K	+4.6%	2
2026-07	3.6K	+9.5%	2
2026-06	3.2K	+5.8%	2
2026-05	3.1K	—	2
2026-03	2.5K	—	1

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.9 KB · ClawHub v1.0.0

---
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

Show all (130 lines)

---

# Perplexity Search

Search the web using Perplexity's Search API for ranked, real-time results.

## Quick Start

Basic search:

```bash
python3 {baseDir}/scripts/search.py "your search query"
```

With options:

```bash
# 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`:

```json
{
  "skills": {
    "perplexity-search": {
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

**Option 2: Environment variable**

```bash
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:

```json
{
  "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:**
```bash
python3 {baseDir}/scripts/search.py "golf coaching Instagram trends" --count 10
```

**Recent News:**
```bash
python3 {baseDir}/scripts/search.py "AI regulation updates" --recency week
```

**Competitive Analysis:**
```bash
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