pplx-web-query

• What is this?
• Features
• Built With
• Quick Start
• Usage
• Project Structure
• Documentation
• Contributing
• License

What is this?

A universal Agent Skill that enables any AI coding agent — OpenCode, Claude Code, Codex CLI — to perform web searches through Perplexity's interface. It launches Chromium, navigates to perplexity.ai, submits a query, captures the generated answer from the clipboard, and writes it to a Markdown file.

No API key. No subscription. Just browser automation.

Features

• Browser automation — Launches Chromium, navigates Perplexity, submits queries
• Answer extraction — Clicks "Copy" on the generated response, reads from clipboard
• Retry logic — Handles empty clipboard, slow responses, and transient failures (3 retries)
• Markdown output — Saves answers as .md files preserving Perplexity's formatting
• Multi-agent — Works with OpenCode, Claude Code, and Codex CLI out of the box
• Clean I/O — Stderr for logs, stdout for output — pipe-friendly

Built With

• — Runtime
• — Browser automation
• — Version control

Quick Start

Prerequisites: Node.js >= 18 and Chromium browsers.

cd skills/perplexity-webui-search
npm install
npx playwright install chromium
npm run search -- "What are the latest Playwright changes?" ./result.md

The command opens Chromium, sends the prompt to Perplexity, copies the answer, saves it to result.md, and prints it to stdout.

Usage

As an Agent Skill

Install into your agent's skill directory:

OpenCode:

npx skills add ./skills --skill perplexity-webui-search --agent opencode --copy

Or copy skills/perplexity-webui-search/ into ~/.config/opencode/skills/.

Codex CLI:

npx skills add ./skills --skill perplexity-webui-search --agent codex --copy

Claude Code and others:

Copy skills/perplexity-webui-search/ into your agent's skills directory.

Direct CLI

node scripts/perplexity-query.js "your query" ./output.md

Output

Answers are saved as plain Markdown. Perplexity's formatting is preserved verbatim from the clipboard.

npm run search -- "What is Rust?" ./rust-overview.md
# → rust-overview.md contains the full Perplexity answer

Checks

npm test              # Unit tests
npm run check         # Syntax validation
npm run pack:dry-run  # Verify publish-ready package

Project Structure

skills/
  perplexity-webui-search/
    scripts/
      perplexity-core.js         # Core: args, retry, Playwright automation
      perplexity-core.test.mjs   # Unit tests
      perplexity-query.js        # CLI entry point
    references/
      install-opencode.md
      install-codex.md
      install-claude.md
      troubleshooting.md
    LICENSE
    README.md
    SKILL.md
    package.json
docs/
  assets/
    logo.png
.gitignore
LICENSE
README.md
README.fr.md

Documentation

Contributing

Contributions are welcome. This is a public project — fork, branch, and open a PR.

1. Fork the repo
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m "feat: add amazing feature")
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.