answersearch

Name: answersearch
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords搜索与检索02 周前更新

代码仓库

关于 answersearch

answersearch 通过命令行工具和 MCP 服务提供 Perplexity API 的搜索与问答能力，面向需要来源明确的网页答案、排序搜索结果、分析推理或深入研究的终端用户和 Agent。

主要功能

01获取基于搜索的对话式答案
02检索排序后的网页结果
03调用推理模型进行分析
04请求耗时更长的深入研究
05用作命令行工具或 stdio MCP 服务

适用场景

01利用实时网页搜索回答问题
02按可配置预算收集排序结果
03分析和推演问题
04委托更广泛的研究任务

MCP 相关

stdio MCP 服务提供 Perplexity 对话问答、直接搜索、分析推理和深入研究工具。调用需要 Perplexity API 密钥；上游故障会作为工具错误返回。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-answersearch": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/answersearch"
      ]
    }
  }
}

启动命令npx -y @reneturcios/answersearch

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/answersearch0.1.0stdio

ocighcr.io/cloudcorprecords/answersearch:0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
messages	array	是	按顺序排列的对话消息对象数组，每个对象都包含 role 和 content 字符串，用于构成发送给模型的提示词或对话。

详细介绍

answersearch

answersearch 让你可以在终端或 Agent 中使用 Perplexity 的模型。你可以向基于搜索的模型提问并获取附带来源的回答，单独获取按排名排序的网页结果，将难题交给推理模型，或委托它进行更慢、更深入的研究，在撰写前广泛阅读。它可以作为小型命令行工具或 MCP 服务运行，并且需要 Perplexity API 密钥。

设置

从 Perplexity API 门户获取密钥并导出：

export PERPLEXITY_API_KEY=<redacted>

如果未设置该变量，每条命令和工具调用都会失败，并提示 PERPLEXITY_API_KEY — 不会向任何地方发送任何内容。

安装

npx @reneturcios/answersearch ask "what changed in the latest Node LTS?"

或者运行容器镜像：

docker run -i -e PERPLEXITY_API_KEY ghcr.io/cloudcorprecords/answersearch

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

# Conversational answer grounded in live web search (sonar-pro)
answersearch ask "who won the marathon last weekend?"

# Ranked search results only, with optional budgets
answersearch search "composting basics" --max-results 5 --max-tokens 4000 --max-tokens-per-page 512

# Step-by-step reasoning (sonar-reasoning-pro)
answersearch reason "prove that the square root of two is irrational"

# Deep, multi-source research (sonar-deep-research) — this one takes a while
answersearch research "compare the failure modes of lithium and sodium batteries"

answersearch --version

调用成功时会输出 API 的 JSON 响应。退出代码：成功时为 0，API 调用失败时（包括缺少密钥）为 1，用法错误时为 2。

MCP 服务

一个可执行文件即可提供两种用法。mcp 子命令会启动一个 stdio MCP 服务：

npx -y @reneturcios/answersearch mcp

MCP 客户端配置：

{
  "mcpServers": {
    "answersearch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/answersearch", "mcp"],
      "env": { "PERPLEXITY_API_KEY": "your-key-here" }
    }
  }
}

工具

工具	输入	功能
`perplexity_ask`	`messages`（`{role, content}` 数组，必填）	通过聊天补全端点上的 `sonar-pro` 模型进行实时网页搜索并提供对话式回答。
`perplexity_search`	`query`（字符串，必填）、`max_results`、`max_tokens`、`max_tokens_per_page`（整数，可选）	直接调用 Search API；返回其排名结果和上游提供的元数据。
`perplexity_reason`	`messages`（必填，格式相同）	通过 `sonar-reasoning-pro` 进行分析推理。
`perplexity_research`	`messages`（必填，格式相同）	通过 `sonar-deep-research` 进行深度研究；预计等待时间会比其他工具更长。

工具结果是上游 JSON，以格式化文本形式呈现。上游故障（密钥无效、配额不足、HTTP 错误）会作为工具错误返回，其中包含状态和 API 自身的错误消息。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx