コーディングエージェントに「いまの Web」や一次情報を渡したい場面は増えています。一方で、ブラウザ自動化や自前の search ラッパは、DOM の揺れ、JSON 契約の不統一、再現可能なセットアップの欠如で運用コストが膨らみがちです。
📑目次
pplx が提供するもの
Perplexity CLI（pplx） は、Perplexity 公式が公開した端末向け CLI です。Search API を成功時 stdout の JSON で返します。
中核コマンドは次の2つで、人間とエージェントの両方から同じ契約で扱えます。
pplx search web（ヒット一覧）pplx content fetch（クリーン本文）
本記事では、公式 README と Agent Skill、および同日帯の独立報道・運用ガイドに基づき、インストールから Claude Code 連携、採用判断までを手順と制限付きで整理します。
pplx とブラウザ自動化の違い
設計の中心
結論から言うと、pplx は「クリック操作でページを読むツール」ではなく、「Search API を JSON 契約で叩く公式 CLI」です。エージェントが tool-call や jq で機械可読なヒットと本文を受け取りやすい点が設計の中心です。
機能比較
| 項目 | pplx（公式 CLI） | ブラウザエージェント / 独自ラッパ |
|---|---|---|
| 提供者 | Perplexity 公式 GitHub perplexityai/perplexity-cli |
各ツール・自前実装 |
| 出力 | 成功時 stdout JSON 1 オブジェクト | HTML/DOM や非統一 JSON が多い |
| 主コマンド | pplx search web / pplx content fetch |
クリック操作・スクレイプ等 |
| 認証 | PERPLEXITY_API_KEY（エージェント推奨）または TTY の auth login |
Cookie/セッション依存になりやすい |
| OS | macOS arm64 / Linux x86_64・arm64（Windows ネイティブなし） | 環境依存 |
| エージェント連携 | 公式 Agent Skill + Claude Code plugin 手順 | 個別プロンプト・MCP 等 |
| 更新 | pplx update（checksum 検証、API key 不要） |
手動追従 |
出典と参考画面
出典: perplexityai/perplexity-cli、pplx-cli Agent Skill（2026年7月時点）
search と fetch の返り値
search web は次を返します。
- hits（url / title / domain / snippet など）
- total
content fetch は指定 URL のクリーン本文とメタデータに加え、次のフラグを持ちます。
erroris_paywall
TechDaily（2026-07-25）も、コーディングエージェント向けに realtime search と page text fetch の二操作がある点を同日帯で独立に伝えており、公式 CLI の存在自体は GitHub 以外でも確認できます。
どちらを選ぶか
ブラウザ自動化が向くのは、ログイン後 UI の操作や、API が無い画面フローの再現です。
一方、次だけが欲しいなら pplx の方が契約が短く、エージェント側のパースも安定しやすいです。
- ドメインや recency で絞ったヒット一覧
- 信頼前に paywall を見られるクリーン本文
インストールと認証
対応 OS
まず対応 OS を確認してください。公式バイナリは次の3系統です。Windows ネイティブは対象外で、独立ガイドでは WSL2 経由が言及されますが、公式表には載りません。
| Platform | Asset |
|---|---|
| macOS Apple Silicon | pplx-aarch64-apple-darwin.bin |
| Linux x86_64 | pplx-x86_64-linux-gnu.bin |
| Linux arm64 | pplx-aarch64-linux-gnu.bin |
出典: perplexityai/perplexity-cli README（2026年7月時点）
インストール手順
ワンライナ（SHA-256 検証、sudo 不要、既定 ~/.local/bin/pplx）:
curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh
確認手順:
~/.local/binを PATH に入れるpplx --versionで calver 風のバージョン（例:2026.07.23....+sha）が出ることを確認する
手動経路では release の platform binary と SHA256SUMS を shasum -a 256 -c（Linux は sha256sum）で検証して配置します。インストール先は PPLX_INSTALL_PATH で変更できます。
認証と更新
認証は次の優先順位です。
- キー発行: Perplexity API
- エージェント / CI:
export PERPLEXITY_API_KEY=pplx-...（推奨） - 対話のみ:
pplx auth login（TTY 必須。パイプ入力は拒否） - env と stored key が両方ある場合は env が優先
- 未設定のまま実コマンドを叩くと
AUTHENTICATIONエラー
エージェント実行環境に TTY login を書かないでください。公式 Agent Skill も、エージェントは PERPLEXITY_API_KEY を export する前提を明示しています。
更新・削除の要点:
- 更新:
pplx update/pplx update --check（checksum 検証付き・API key 不要、v0.2.2+） - アンインストール: binary、receipt、credentials パスを削除
基本コマンド — search web と content fetch
search web
基本形:
pplx search web "Perplexity CLI pplx install"
よく使うオプション
- 件数:
-n 5（default 10） - ドメイン:
--domains wikipedia.org,arxiv.org/--excluded-domains - 相対期間:
--recency-filter week（hour / day / week / month / year） - 日付境界:
--published-after-date/--published-before-date（MM/DD/YYYY。ISO ではない） - 国:
--country（default US） - トークン抑制:
--output-dir DIR --stdout-preview=200
成功・失敗と禁止組合せ
成功時は exit 0 と stdout の JSON 1 オブジェクト、失敗時は exit 1・stdout 空・stderr に JSON error（error.code）です。複数の位置引数は「別トピックの並列検索」ではなく、同一質問の言い換えとして扱われます。別テーマは別 invocation にしてください。
⚠️ 禁止組合せ: --recency-filter と published-after/before の同時指定はサーバ側 BAD_REQUEST になります。また --stdout-preview は --output-dir または PPLX_OUTPUT_DIR と併用しないと no-op です。「preview だけ付ければ短くなる」は誤解です。
content fetch
pplx content fetch https://example.com
http(s) のみ対象です。本文を信頼する前に、必ず次を見てください。
erroris_paywall
paywall フラグは検知であって突破ツールではありません。
運用メモ:
--htmlはraw_htmlが大きくなりやすいので、save + preview を推奨- キャッシュ既定。ライブが必要なら
--no-cache PPLX_OUTPUT_DIRを決め、エージェントの tool 結果に巨大 JSON を載せないルールを CLAUDE.md などに書く
Search / Sonar API は従量課金前提で、Pro に含まれるかは README だけでは確定しません。ダッシュボードで確認し、「学習データで足りるなら検索しない」しきい値を決めてください。
Claude Code / Cursor への載せ方
Skill と plugin
公式 README は、エージェント向けに Skill URL を読ませる導線と、Claude Code plugin 手順の両方を示しています。
Skill 読み込みの例（README 記載）:
Read https://raw.githubusercontent.com/perplexityai/api-platform-developers/main/skills/pplx-cli/SKILL.md, install the skill, and use it for search.
Claude Code plugin:
/plugin marketplace add perplexityai/api-platform-developers/plugin install perplexity-platform@api-platform-developers
運用ルール
実務では次をセットで書くと再現性が上がります。
- 実行環境に
PERPLEXITY_API_KEYを secret store 経由で渡す（TTY login 禁止） - CLAUDE.md に「いつ search するか」「
-n上限」「output-dir + preview」を1段落で書く - プロジェクト単位で Skill を整え、呼び出し条件を固定する
- MCP 常駐と比較し、必要なときだけ CLI を呼ぶ方針を決める
CLI と MCP の使い分け
筆者の運用では、以前は MCP を積極利用していましたが、CLI の方がコンテキスト消費が低くエージェントの扱いも安定しやすいため、可能な範囲で CLI へ寄せています。
一方で次の制約もあります。
- CLI をエージェントが実行できる場所に置く必要がある
- CLI が無いサービスもある
そのため MCP を完全に捨てる必要はありません。統合ごとに最適な経路を選ぶのが現実的です。また、プロジェクトごとに Skill と CLAUDE.md を調整しておくと、検索タイミングとトークン上限のブレを抑えられます。
関連ツールとの切り分け
ブラウザでページを操作したい場合は、Claude Code Desktop の in-app ブラウザのような UI 操作系と役割が重なります。
切り分けの目安:
- JSON 検索・本文取得が主目的 → pplx
- 画面操作が主目的 → ブラウザ系
関連記事（ツールチェーン設計の参考）:
- Claude Code Desktop に in-app ブラウザ
- コーディングエージェント向け HTML 取得 CLI の ax
- Claude Code のハーネス構造
- Claude Code Setup 公式プラグイン
最短手順
読者向けの最短手順:
- install.sh →
pplx --version PERPLEXITY_API_KEYを設定pplx search web "test" -n 3で JSON を確認（domains か recency を1つ試す）pplx content fetchでerror/is_paywallを見る- Claude Code に Skill または plugin を接続し、CLAUDE.md に呼び出し条件を1段落書く
採用前チェックリスト
試す価値がある条件
次を満たすなら pplx を試す価値があります。
- エージェントに機械可読な Web ヒットとクリーン本文が必要
- macOS arm64 または Linux 実行環境がある（または WSL 等で Linux binary を使える）
- Perplexity API キーと従量課金を許容できる
- JSON stdout を jq / tool-call に載せたい
見送り・代替を検討する条件
- Windows のみで WSL も使えない
- ブラウザ UI 操作やログイン壁の突破が主目的
- 完全オフライン、または API 外出し禁止ポリシー
- すでに社内 search API があり、契約・監査要件が別系統
運用チェックリスト
- 対応 OS を確認した
- install.sh または手動 SHA-256 経路を記録した
- エージェント用に
PERPLEXITY_API_KEYを secret store へ入れた -
auth loginを CI に書かない方針にした - search の recency と日付境界を同時指定しないルールを共有した
- fetch 前に error / is_paywall を見る
-
--output-dir+ preview でトークン肥大を抑える - Claude Code / Cursor の呼び出し条件を CLAUDE.md 等に1段落書いた
- 月次で
pplx update --checkする担当を決めた
関連記事:
- グラフとループの使い分け｜導入判断チェックリスト【2026】
- Claude CoworkのRecord a skillとは｜Macで画面録画から再利用スキルを作る手順と導入判断
- Claude Opus 5が浅く感じる原因｜lean promptとCLAUDE.md改修
よくある質問（FAQ）
Q1. Windows でも使えますか？
公式バイナリは macOS arm64 と Linux のみです。ネイティブ Windows は対象外です。WSL2 等は独立ガイドで言及されますが、公式対応表には含まれません。
Q2. pplx auth login をエージェントから使えますか？
使えません（TTY-only）。エージェント / CI は PERPLEXITY_API_KEY を使います。
Q3. --stdout-preview だけ付ければ出力は短くなりますか？
なりません。--output-dir または PPLX_OUTPUT_DIR と併用したときだけ有効です。
Q4. 日付は ISO（YYYY-MM-DD）で渡せますか？
公式は MM/DD/YYYY です。また recency-filter と日付境界の併用は BAD_REQUEST になります。
Q5. Claude Code への最短導線は？
marketplace add → plugin install、または Skill URL を読ませて install です。キーは env で渡します。
Q6. 料金は Pro に含まれますか？
CLI 自体は API キー経由で、Search / Sonar の従量課金が前提です。Pro 込みかは README では未確定なので、ダッシュボードで確認してください。
まとめ — 今日やる3ステップ
pplx は、コーディングエージェントに「最新 Web と一次情報」を JSON で渡すための、公式かつ再現性の高い最短経路です。ブラウザ自動化を置き換える万能ツールではなく、search と fetch の契約がはっきりしている点が強みです。
今日やること:
- install.sh を実行し
pplx --versionを確認する PERPLEXITY_API_KEYを設定しpplx search web "test" -n 3を試す- Claude Code に Skill / plugin を載せ、CLAUDE.md に呼び出し条件を書く
OS 制限、エージェントでの TTY login 禁止、recency と日付境界の同時指定禁止、fetch の paywall / error 確認、従量コストの5点だけは、チームルールに残しておくと事故を防げます。次の深掘りは、社内 secret 管理、ドメイン allowlist、月次 update 運用です。
著者
krona23
IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。
コメントを残す