使用说明

困惑Web MCP&CLI

_{▶️ Watch the Demo Overview}

MCP服务器、CLI和兼容API的界面，用于困惑AI的web界面。

使用您的Perplexity Pro/Max订阅，通过MCP工具或作为API端点，从终端访问高级型号（GPT-5.4、GPT-5.5、Claude 4.7 Opus、Clauded 4.6 Sonnet、Gemini 3.1 Pro、Nemotron 3 Super、Kimi K2.6）。

特性

命令行界面：直接从终端查询困惑模型(pwm ask, pwm council, pwm research)
MCP服务器：22个用于人工智能代理的MCP工具，包括引用、源发现和速率限制检查
API服务器：投放人类信息API和OpenAI聊天完成API
8型号：GPT-5.4、GPT-5.5、克劳德4.7 Opus、克劳德4.6 Sonnet、双子座3.1 Pro、尼莫通3 Super、基米K2.6、声纳2
思维方式：为所有兼容型号提供扩展思维支持
深入研究：全力支持困惑深度研究模式
模范理事会：并行查询多个模型并获得综合共识
设置和技能管理：自动配置MCP用于Claude Code、Cursor、Windsurf、Gemini CLI、Codex、Cline、Antigravity；在9个平台上安装代理技能
医生：诊断安装、身份验证、配置、速率限制和技能状态

振动编码警报

完全透明：该项目由非开发人员使用AI编码助手构建。如果你是一个经验丰富的Python开发人员，你可能会看看这个代码库和wince。没关系。

这里的目标是学习——既要学习用Python构建CLI工具，也要学习现代web应用程序是如何工作的。代码是有效的，但它在很大程度上是一个纯粹为了研究和教育目的而发布的学习项目，而不是一个精美的产品。

[！警告] 非官方&不支持 --这个项目是 不隶属于、不受或不受Perplexity AI支持。它通过非官方、未记录的方法与Perplexity的web界面交互，如果Perplexiity更改其内部API或RPC，这些方法可能会随时中断，恕不另行通知。使用风险自负。作者对您的困惑账户的任何后果不承担任何责任，包括但不限于利率限制、暂停或终止。本项目严格按照 仅用于教育和研究目的.

如果你知道得更好，教我们。 欢迎PR、问题和架构建议。这是开源的，因为人类的专业知识是不可替代的。

安装

来自PyPI（推荐）

使用紫外线：

uv tool install perplexity-web-mcp-cli

使用pipx：

pipx install perplexity-web-mcp-cli

使用pip：

pip install perplexity-web-mcp-cli

注：需要Python 3.10-3.13。

来源（用于开发）

git clone https://github.com/jacob-bd/perplexity-web-mcp.git
cd perplexity-web-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

升级

pip install --upgrade perplexity-web-mcp-cli

升级后，重新启动MCP客户端（Claude Code、Cursor等）以重新加载服务器。

快速开始

# 1. Authenticate
pwm login

# 2. Ask a question
pwm ask "What is quantum computing?"

# 3. Deep research
pwm research "agentic AI trends 2026"

# 4. Check your remaining quotas
pwm usage

# 5. Set up MCP for your AI tools
pwm setup add all           # Interactive setup for all detected tools
pwm setup add cursor        # Or add individually

# 6. Install the Agent Skill
pwm skill install claude-code

# 7. Diagnose any issues
pwm doctor

CLI 参考

查询

问困惑一个问题。默认情况下，困惑会自动选择最佳模型。

pwm ask "What is quantum computing?"

选择特定型号 和 -m （参见模型完整列表）：

pwm ask "Compare React and Vue" -m gpt54

pwm ask "Explain the attention mechanism" -m claude_sonnet

实现扩展思维 和 -t 为了进行更深入的推理（在具有Toggle思维的模型上可用）：

pwm ask "Prove that the square root of 2 is irrational" -m claude_sonnet --thinking

关注特定来源 和 -s 要控制困惑搜索的位置：

# Search only academic papers and scholarly articles
pwm ask "transformer architecture improvements 2025" -s academic

# Search only social media (Reddit, Twitter, etc.)
pwm ask "best mechanical keyboard 2026" -s social

# Search SEC EDGAR financial filings
pwm ask "Apple revenue Q4 2025" -s finance

# Search all source types at once
pwm ask "latest AI news" -s all

输出选项：

# JSON output (for piping to other tools)
pwm ask "What is Rust?" --json

# Suppress citation URLs (answer text only)
pwm ask "What is Rust?" --no-citations

组合旗帜 为了实现完全控制：

pwm ask "recent advances in protein folding" -m gemini_pro -s academic --json

深入研究

运行困惑的深度研究模式，获取来源广泛的深度报告。使用单独的每月配额。

pwm research "agentic AI trends 2026"

pwm research "climate policy impact on renewable energy" -s academic

pwm research "NVIDIA competitive landscape" -s finance --json

模范理事会

并行查询多个模型，得到综合共识。每个型号售价1 Pro Search。默认合成使用Sonar 2（也是1 Pro Search）。

# Default: GPT-5.4, Claude Opus, Gemini Pro + Sonar 2 synthesis (4 Pro Searches)
pwm council "What are best practices for microservices?"

# Custom model selection
pwm council "Compare Rust and Go" -m gpt54,claude_sonnet

# Enable extended thinking for all council models
pwm council "Prove the Pythagorean theorem" --thinking

# Skip synthesis, output as JSON
pwm council "React vs Vue" --no-synthesis --json

认证

pwm login                                    # Interactive login (email + OTP)
pwm login --check                            # Check if authenticated
pwm login --email user@example.com           # Send verification code (non-interactive)
pwm login --email user@example.com --code 123456  # Complete auth with code

使用和限制

pwm usage                  # Check remaining rate limits
pwm usage --refresh        # Force-refresh from Perplexity servers

黑客

无缝启动连接到困惑API服务器的外部人工智能工具。这将自动启动本地 pwm api 服务器在后台，设置所需的环境变量，并启动该工具。

pwm hack claude            # Launch Claude Code
pwm hack claude -m gpt54   # Launch Claude Code with a specific model

MCP设置

pwm setup list             # Show supported tools and MCP configuration status
pwm setup add all          # Interactive: detect and configure all tools
pwm setup add claude-code  # Add MCP server to Claude Code
pwm setup add cursor       # Add MCP server to Cursor
pwm setup add codex        # Add MCP server to Codex CLI
pwm setup add gemini       # Add MCP server to Gemini CLI
pwm setup add windsurf     # Add MCP server to Windsurf
pwm setup add cline        # Add MCP server to Cline CLI
pwm setup add antigravity  # Add MCP server to Antigravity
pwm setup remove all       # Remove from all configured tools
pwm setup remove cursor    # Remove MCP server from a tool

技能管理

pwm skill list                            # Show installation status per platform
pwm skill install claude-code             # Install skill for Claude Code
pwm skill install cursor --level project  # Install at project level
pwm skill uninstall gemini-cli            # Remove skill
pwm skill update                          # Update all outdated skills
pwm skill show                            # Display skill content

医生

pwm doctor                 # Diagnose installation, auth, config, limits
pwm doctor -v              # Verbose (includes security + per-platform skill status)

AI文档

pwm --ai                   # Print comprehensive AI-optimized reference

模型

CLI名称	提供者	思考	注释
`auto`	困惑	否	自动选择最佳型号
`sonar`	困惑	否	声纳2（最新内部；API id `experimental`)
`deep_research`	困惑	否	月度配额，深度报告
`gpt54`	OpenAI	切换	GPT-5.4
`gpt55`	OpenAI	切换	GPT-5.5（需要最大层）
`claude_sonnet`	拟人	切换	克劳德4.6十四行诗
`claude_opus`	拟人	切换	克劳德4.7 Opus（需要最大级别）
`gemini_pro`	谷歌	始终	Gemini 3.1 Pro
`nemotron`	NVIDIA	始终	Nemotron 3 Super 120B
`kimi_k26`	登月AI	切换	基米K2.6

来源焦点

使用以下命令控制困惑搜索的位置 -s （CLI）或 source_focus （MCP）：

选项	描述	示例用例
`web`	常规网络搜索（默认）	新闻，一般问题
`academic`	学术论文、期刊	研究、引用、科学主题
`social`	Reddit、Twitter、论坛	意见、建议、社区情绪
`finance`	SEC EDGAR文件	公司财务、监管文件
`all`	网络+学术+社交结合	广泛覆盖所有来源

MCP服务器

设置

配置MCP的最简单方法：

pwm setup add claude-code

或者为任何MCP客户端手动配置：

克劳德代码CLI：

claude mcp add perplexity pwm-mcp

克劳德桌面版 --下载 .mcpb 延伸自最新版本并使用Claude Desktop打开它。或手动配置：

{
  "mcpServers": {
    "perplexity": {
      "command": "pwm-mcp"
    }
  }
}

光标 (~/.cursor/mcp.json):

{
  "mcpServers": {
    "perplexity": {
      "command": "pwm-mcp"
    }
  }
}

可用的MCP工具

查询工具组：

工具	说明
`pplx_query`	灵活：模型选择+思维切换
`pplx_ask`	快速问答（自动选择最佳型号）
`pplx_deep_research`	有消息来源的深度报告
`pplx_sonar`	困惑声纳2（1专业搜索）
`pplx_gpt54` / `pplx_gpt54_thinking`	GPT-5.4
`pplx_gpt55` / `pplx_gpt55_thinking`	GPT-5.5
`pplx_claude_sonnet` / `pplx_claude_sonnet_think`	克劳德4.6十四行诗
`pplx_claude_opus` / `pplx_claude_opus_think`	克劳德4.7作品集（最高级别）
`pplx_gemini_pro_think`	Gemini 3.1 Pro（始终思考）
`pplx_nemotron_thinking`	Nemotron 3超级（思考永远在）
`pplx_kimi_k26` / `pplx_kimi_k26_thinking` 是K2.6。

智能路由（1）：

工具	说明
`pplx_smart_query`	配额感知路由——根据限制自动选择最佳模型

理事会（1）：

工具	说明
`pplx_council`	并行查询多个模型，可选综合

用法、源代码和身份验证工具（5）：

工具	说明
`pplx_usage`	检查剩余配额
`pplx_sources`	列出可用源/连接器和高级源配额
`pplx_auth_status`	检查身份验证状态
`pplx_auth_request_code`	将验证码发送到电子邮件
`pplx_auth_complete`	使用6位代码完成身份验证

所有查询工具支持 source_focus: none, web, academic, social, finance, all, github, wiley, cbinsights, pitchbook, statista、原始源ID和逗号分隔的列表。

API服务器

通过Anthropic或OpenAI兼容的API端点使用困惑模型。

启动服务器

pwm api

API（克劳德代码）

export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_API_KEY=perplexity
claude --model gpt-5.4

或者，使用以下工具无缝启动Claude Code hack 命令，自动启动API服务器并为您配置环境：

pwm hack claude

OpenAI API

export OPENAI_BASE_URL=http://localhost:8080/v1
export OPENAI_API_KEY=anything

API型号名称

API名称	困惑模型	思考
`perplexity-auto`	最佳（自动选择）	否
`gpt-5.4`	GPT-5.4	切换
`claude-sonnet-4-6`	克劳德4.6十四行诗	切换
`claude-opus-4-7`	克劳德4.7作品	切换
`gemini-3.1-pro`	Gemini 3.1 Pro	始终
`nemotron-3-super` / `nemotron`	尼莫特隆3超级	总是

旧别名(claude-3-5-sonnet, claude-3-opus)支持兼容性。

Python API

from perplexity_web_mcp import Perplexity, ConversationConfig, Models

client = Perplexity(session_token="your_token")
conversation = client.create_conversation(
    ConversationConfig(model=Models.CLAUDE_45_SONNET)
)

conversation.ask("What is quantum computing?")
print(conversation.answer)

for result in conversation.search_results:
    print(f"Source: {result.url}")

# Follow-up (context preserved)
conversation.ask("Explain it simpler")
print(conversation.answer)

订阅级别和费率限制

层级	成本	专业搜索	深度研究	实验室
免费	0美元	3/天	1/月	否
Pro	每月20美元	每周池	每月池	每月池子
最大值	每月200美元	每周池	每月池	每月库

MCP服务器在每次查询之前检查配额。使用 pwm usage 或 pplx_usage 检查你的极限。

故障排除

身份验证错误（403）

会话令牌持续约30天。过期后重新进行身份验证：

pwm login

非交互式（适用于AI代理）：

pwm login --email your@email.com

pwm login --email your@email.com --code 123456

通过MCP工具（适用于没有外壳的AI代理）：

呼叫 pplx_auth_request_code(email="your@email.com")
检查电子邮件中的6位代码
呼叫 pplx_auth_complete(email="your@email.com", code="123456")

诊断问题

pwm doctor

这将检查安装、身份验证、速率限制、MCP配置和技能安装，并为发现的每个问题提供修复建议。

速率限制

CLI/MCP：每次查询前自动检查配额，如果配额用尽，则阻止
API服务器：要求两次请求之间至少间隔5秒

代理技能

该项目包括一个便携式代理技能（SKILL.md），教AI代理如何使用CLI和MCP工具。为您的平台安装它：

pwm skill install all              # Install for all detected tools
pwm skill install claude-code      # Or install individually
pwm skill install cursor
pwm skill install codex
pwm skill install gemini-cli
pwm skill install antigravity
pwm skill install cline
pwm skill install opencode
pwm skill install openclaw
pwm skill install alef-agent

该技能遵循Anthropic的Agent Skills开放标准，适用于任何兼容的AI平台。

学分

最初分叉自困惑webui scraper 通过亨利编码器.

许可证

麻省理工学院