# Perplexity Webui Search

> Use when the user asks to search Perplexity, query Perplexity through the web UI, perform web research with Perplexity, save a Perplexity answer as Markdown, or retrieve a Perplexity answer through browser automation.

- **Type:** Skill
- **Install:** `agentstack add skill-sofianbll-pplx-web-query-perplexity-webui-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sofianbll](https://agentstack.voostack.com/s/sofianbll)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sofianbll](https://github.com/sofianbll)
- **Source:** https://github.com/sofianbll/pplx-web-query/tree/main/skills/perplexity-webui-search
- **Website:** https://sofian-bll.github.io/pplx-web-query/

## Install

```sh
agentstack add skill-sofianbll-pplx-web-query-perplexity-webui-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Perplexity WebUI Search

## Overview

This skill runs the bundled Playwright script against Perplexity's web UI and returns the copied Markdown answer. It is a browser automation path, not an official Perplexity API client.

## Use And Avoid

Use for explicit Perplexity tasks:

- Search Perplexity directly.
- Use Perplexity for research instead of generic webpage fetching.
- Retrieve or save a Perplexity answer through a visible browser session.

Do not use for:

- The user asks for a normal web fetch, URL extraction, or documentation lookup.
- The environment cannot open Chromium.
- Network access to `https://www.perplexity.ai/` is unavailable.
- The task requires an official Perplexity API.

## Workflow

1. Work from this skill directory, wherever it is installed.
2. If dependencies are missing, run `npm install`.
3. If Chromium is missing, run `npx playwright install chromium`.
4. Run the search command with the user query and an output path.
5. Read the output file before answering the user.
6. If the browser is blocked, times out, copies an empty response, or the UI changes, say that clearly and do not claim Perplexity was searched.

## Command

```bash
npm run search -- "" ./result.md
```

The command opens visible Chromium, submits the query, waits for the final `Copy` button, writes the copied answer to the output file, and prints the answer to stdout. Progress logs go to stderr.

## Output Handling

- Default output path: `result.md`.
- Prefer a task-specific path such as `./tmp/perplexity-result.md` when the user asks to preserve output.
- `result.md` is generated output and should not be committed.
- Read the output file and summarize the answer; do not just report that the command ran.

## Response Pattern

- Success: summarize the Perplexity answer and include relevant citations copied in the output.
- Failure: state `Perplexity search did not complete: `. Do not invent an answer or fall back to generic web search unless the user asks.

## Common Mistakes

- Running from another directory without installing dependencies in this skill directory.
- Reporting success from stdout alone without reading the output file.
- Committing generated files such as `result.md` or files under `tmp/`.
- Treating this as an official Perplexity API client.

## Troubleshooting

If setup or runtime fails, read [references/troubleshooting.md](references/troubleshooting.md) and report the concrete failure. Do not claim Perplexity was searched unless the command produced a non-empty answer.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sofianbll](https://github.com/sofianbll)
- **Source:** [sofianbll/pplx-web-query](https://github.com/sofianbll/pplx-web-query)
- **License:** MIT
- **Homepage:** https://sofian-bll.github.io/pplx-web-query/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sofianbll-pplx-web-query-perplexity-webui-search
- Seller: https://agentstack.voostack.com/s/sofianbll
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.