helallao/perplexity-ai

このプロジェクトの目的

Perplexity AI は、公式 API キーを使わずに Perplexity AI 検索エンジンをプログラムから利用できる Python ライブラリです。Perplexity の内部 Web エンドポイントをリバースエンジニアリングし、Emailnator を介して新しい Gmail アカウントを作成するブラウザ自動化ツールも含まれており、1 日 5 回の無料 Pro クエリをリセットできます。

これは、Perplexity の非公式で高機能なクライアントであり、以下をサポートしています：

• 検索モード：auto、pro、reasoning、deep research
• 基盤モデルの選択（例：GPT‑5、Claude 4.5、Grok など）
• ドキュメント Q&A のためのファイルアップロード
• ストリーミング応答
• フォローアップ質問
• 同期および非同期 API
• アカウント生成のための Web インターフェース（ブラウザ自動化）
• MCP（Model Context Protocol）サーバー。Claude Code などのツールが Perplexity を検索バックエンドとして使用できます。

主な機能

• アカウント生成 – Emailnator を使用して使い捨て Gmail アカウントを作成し、無料 Pro クエリ制限を更新します。
• MCP サーバー – Perplexity 検索をツール（perplexity_ask、perplexity_research など）として MCP クライアント（Claude Code など）に公開します。API キーは不要で、代わりに Cookie を使用します。
• 柔軟な検索 – モード、モデル、ソース（ウェブ/学術/ソーシャル）を選択し、ファイルをアップロードし、回答をストリーミングできます。
• 堅牢なエラーハンドリングとロギング – カスタム例外と構造化ロギング。
• 非同期および同期 API – perplexity（同期）と perplexity_async モジュールの両方を提供。
• Web 自動化 – Patchright（検出されない Chrome）を使用して、実際のブラウザでアカウント作成と使用を自動化します。

仕組み

このライブラリは、Perplexity のプライベート Web クエリエンドポイントを利用します。次のいずれかが可能です：

• 匿名で使用（auto モードのみに制限）、または
• 独自の Perplexity Cookie を提供して pro、reasoning、deep research をロック解除。

無制限の Pro クエリのために、ライブラリは Emailnator を介して新しい Gmail アドレスを自動的に作成し、無料層の許容量を毎回リセットします。

MCP サーバーは別のプロセス（stdio または HTTP）として実行され、Perplexity をツールとして公開します。長時間実行される研究ジョブのためにローカル SQLite ジャーナルを保持し、永続的なステータス追跡とグレースフルな失敗処理を提供します。

注目すべき点

• 隠れた API の周りに堅牢なクライアントを構築する方法を示しています。ストリーミング、ファイルアップロード、非同期サポート、本格的な MCP 統合を備えています。
• ジャーナルベースの研究タスクシステムの組み込みは、信頼性のための慎重なエンジニアリング（バックグラウンドワーカー、冪等性、キュー制限）を示しています。
• サードパーティの AI サービスを MCP を介してエージェントワークフローに統合する方法を示しています。これは 2025 年のホットトピックです。

注意点

• ToS と倫理的な懸念：アカウント生成機能は、使い捨てアカウントを作成して「無制限の Pro クエリ」を実現することで、Perplexity の利用規約に違反する可能性があります。自己責任で使用してください。
• 公式 API キーは不要 – ただし、このアプローチはいつでも変更される可能性のあるエンドポイントをスクレイピングすることに依存しています。
• Windows の制限 – ファイル権限の制約により、研究ジャーナル MCP ツールは POSIX システムでのみサポートされています。

要するに：公式 API なしで Web サービスでできることの限界を押し広げる、賢くてよく設計された非公式クライアントです。