Menu
Search the web using Perplexity AI API. Returns sourced, up-to-date information.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create a new sub-agent — no Terraform, no Docker by default. Starts as a systemd service, patched into the bridge immediately so @agent works right away.
Commit and push repo changes to GitHub using the standard Iris workflow.
Send an email via Resend API from ${IRIS_EMAIL_FROM:-iris@example.com}. Use when human escalation is needed or to deliver results outside Slack/Telegram.
Transcribe an audio file (m4a, mp3, wav, ogg, webm) to text using OpenAI Whisper API. Use when a user shares a voice note or audio attachment.
Add, remove, and test MCP (Model Context Protocol) servers by editing meta/mcp.json. Tools from connected servers appear automatically as mcp__<server>__<tool>.
Expose a local port as a public HTTPS subdomain under IRIS_BASE_DOMAIN. Writes nginx config, obtains SSL cert via certbot, reloads nginx.
| name | search-web |
| description | Search the web using Perplexity AI API. Returns sourced, up-to-date information. |
| secrets | ["PERPLEXITY-API-KEY"] |
Perform web searches via Perplexity API. Returns AI-summarized results with citations.
search-web "your search query"
# 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"
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:
PERPLEXITY_API_KEY=your-api-key-here
On the Key Vault profile:
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
Returns JSON with:
answer: Summarized answersources: Array of source URLsmodel: Perplexity model used{baseDir}/search.sh — Main search script