Skip to content
Agentmart
Submit a tool

search-web

Search the web using Perplexity AI API.

Skill by irisworks

IndexedApache-2.0★ 13
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/irisworks-search-web

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Search the web using Perplexity AI API. Returns sourced, up-to-date information.

Use cases: backend

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md and code. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Network hosts it talks to 2

  • api.perplexity.ai · found in code
  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/search-web

What's inside

Skill name
search-web
Description
Search the web using Perplexity AI API. Returns sourced, up-to-date information.
License
Apache-2.0
Instructions
58 lines in SKILL.md · view on GitHub

Before installing

  • Ships executable scripts

Files (3)

  • SKILL.md
  • search.js
  • search.sh

SKILL.md (first lines)

# Skill: search-web

Perform web searches via Perplexity API. Returns AI-summarized results with citations.

## Usage

```bash
search-web "your search query"
```

## Examples

```bash
# Simple search
search-web "latest news on AI regulation 2025"

# Technical query  
search-web "Terraform Azure VM module examples"

# Current events
search-web "stock market today S&P 500"
```

## Configuration

Requires the `PERPLEXITY-API-KEY` secret, resolved via `get-secret`.
`bootstrap.sh` prompts for it as an optional step ("Set up web search
(Perplexity)?") — skip it there and add it later by re-running with
`--setup`, or set it directly.

On the default zero-cloud install, set it as an env var in `/iris/.env`:

```bash
PERPLEXITY_API_KEY=your-api-key-here
```

On the Key Vault profile:

```bash
az keyvault secret set --vault-name "$IRIS_KEY_VAULT" \
  --name PERPLEXITY-API-KEY \
  --value "your-api-key-here"
```

Get API key from: https://www.perplexity.ai/settings/api

## Output Format

Returns JSON with:
- `answer`: Summarized answer
- `sources`: Array of source URLs
- `model`: Perplexity model used

## Scripts

- `{baseDir}/search.sh` — Main search script

From irisworks/iris-core, Apache-2.0.

More from irisworks/iris-core

Signals

Stars
13
Forks
3
Open issues
7
Last commit (this folder)
Aug 24, 2026 (2 months ago)
Last release
Oct 14, 2026 (15 days ago)

From GitHub (fetched Oct 24, 2026).

Details

License
Apache-2.0
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from irisworks

Cite this page

search-web skill. Agent Mart. https://agentmart.dev/skills/irisworks-search-web (last updated 2026-10-24)