answersearch

answersearch

answersearch を使うと、Perplexity のモデルをターミナルやエージェントから利用できます。検索結果に基づくモデルに質問して出典付きの回答を得たり、ランキング順のウェブ検索結果だけを取得したり、難しい問題を推論モデルに任せたり、幅広く読み込んでから回答する、時間をかけた詳細な調査を依頼したりできます。小さな CLI または 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 サーバー

1 つのバイナリで両方の用途に対応します。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

ライセンス

MIT — LICENSE を参照してください。