helallao/perplexity-ai

这个项目是做什么的

Perplexity AI 是一个 Python 库，允许你以编程方式查询 Perplexity AI 搜索引擎——无需官方 API 密钥。它通过逆向工程 Perplexity 的内部 Web 端点来实现，并且还包含一个浏览器自动化工具，可以通过 Emailnator 创建新的 Gmail 账户，以重置每天 5 次免费 Pro 查询的限制。

可以把它看作一个非官方的、功能丰富的 Perplexity 客户端，支持：

搜索模式：auto、pro、reasoning、deep research
选择底层模型（例如 GPT‑5、Claude 4.5、Grok 等）
文件上传用于文档问答
流式响应
后续问题
同步和异步 API
用于账户生成的 Web 界面（浏览器自动化）
MCP（模型上下文协议）服务器，使 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 和道德问题：账户生成功能可能违反 Perplexity 的服务条款，通过创建一次性账户实现“无限 Pro 查询”。使用风险自负。
无需官方 API 密钥 – 但该方法依赖于抓取可能随时更改的端点。
Windows 限制 – 由于文件权限限制，研究日志 MCP 工具仅在 POSIX 系统上受支持。

简而言之：一个聪明、工程精良的非官方客户端，突破了在没有官方 API 的情况下使用 Web 服务的界限。