mcpField
P
perplexity

perplexity

github.com/softaworks生産性2.6k774 回インストール34 週間前に更新
リポジトリ

perplexity について

一般的なウェブ検索を Perplexity Search、Perplexity Ask、または researcher agent に振り分けるスキルです。Context7 MCP、Graphite MCP、Nx MCP、URL Crawler を使う場面も示します。

主な機能

  1. 01検索または対話型回答への振り分け
  2. 02深い調査で researcher agent を利用
  3. 03検索結果数の既定値を抑制
  4. 04ドキュメントやワークスペースのクエリを転送

活用シーン

  1. 01最新の実践例やチュートリアルの検索
  2. 02ウェブ情報に基づくトピックの解説
  3. 03URL 付きの情報源の発見
  4. 04ドキュメント検索に適したツールの選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/softaworks/agent-toolkit --skill perplexity

インストール後、Claude Code で/perplexityを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

Perplexity ツール

ユーザーが一般的な検索で「search」「find」「look up」「ask」「research」「what's the latest」と言った場合にのみ使用してください。ライブラリ・フレームワークのドキュメント（Context7 を使用）、gt CLI（Graphite MCP を使用）、ワークスペースに関する質問（Nx MCP を使用）には使用しないでください。

クイックリファレンス

どの Perplexity ツールを使うか？

  • 検索結果や URL が必要？ → Perplexity Search
  • 会話形式の回答が必要？ → Perplexity Ask
  • 詳細なリサーチが必要？ → Researcher エージェント（/research <topic>）

Perplexity ではなく、以下を使用してください:

  • ライブラリ・フレームワークのドキュメント → Context7 MCP
  • Graphite の gt CLI → Graphite MCP
  • このワークスペース → Nx MCP
  • 特定の URL → URL Crawler

Perplexity Search

使用するタイミング:

  • 一般的な検索、リソースの調査
  • 最新のベストプラクティス、最近の情報
  • チュートリアルやブログ記事の発見
  • ユーザーが「search for...」「find...」「look up...」と言った場合

デフォルトパラメータ（必ず使用）:

mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // Default is 10 - too many!
  max_tokens_per_page: 512  // Reduce per-result content
})

上限を増やすタイミング: 以下の場合に限ります:

  • ユーザーが包括的な結果を明示的に必要としている場合
  • 最初の検索で有用な結果が得られなかった場合
  • 複雑なトピックで複数のソースが必要な場合
// Increased limits (use sparingly)
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})

Perplexity Ask

使用するタイミング:

  • 検索結果ではなく、会話形式の説明が必要な場合
  • Web からの情報を統合する場合
  • 現在の文脈を踏まえて概念を説明する場合

使い方:

mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})

使用しない場合:

  • ライブラリのドキュメント（Context7 を使用）
  • 複数ソースにまたがる詳細なリサーチ（researcher エージェントを使用）

禁止ツール

絶対に使用しないもの: mcp__perplexity__perplexity_research

代わりに使用するもの: Researcher エージェント（/research <topic>）

  • トークンコスト: 30〜50k トークン
  • 引用付きで複数ソースを統合して提供
  • 複雑な質問に限って控えめに使用

ツール選択の順序

優先順位:

  1. Context7 MCP - ライブラリ・フレームワークのドキュメント
  2. Graphite MCP - gt CLI に関するあらゆる言及
  3. Nx MCP - このワークスペースに関する質問
  4. Perplexity Search - 一般的な検索
  5. Perplexity Ask - 会話形式の回答
  6. Researcher エージェント - 複数ソースにまたがる詳細なリサーチ
  7. WebSearch - 最後の手段（Perplexity で解決できなかった後）

例

✅ 正しい - Perplexity Search を使用:

  • 「Find postgres migration best practices」
  • 「Search for React testing tutorials」
  • 「Look up latest trends in microservices」

✅ 正しい - Perplexity Ask を使用:

  • 「Explain how postgres advisory locks work」
  • 「What are the trade-offs of microservices?」

❌ 誤り - 代わりに Context7 を使用:

  • 「Search for React hooks documentation」→ Context7 MCP
  • 「Find Next.js routing docs」→ Context7 MCP
  • 「Look up Temporal workflow API」→ Context7 MCP

❌ 誤り - 代わりに Graphite MCP を使用:

  • 「Search for gt stack commands」→ Graphite MCP
  • 「Find gt branch workflow」→ Graphite MCP

❌ 誤り - 代わりに Nx MCP を使用:

  • （このワークスペース内で）「Search for build config」→ Nx MCP
  • （このワークスペース内で）「Find project dependencies」→ Nx MCP

要点

  • デフォルトでは結果数を制限する - コンテキストの肥大化を避ける
  • ライブラリのドキュメント = Context7 - 必ず最初に Context7 を試す
  • 「gt」= Graphite MCP - 「gt」への言及はすべて Graphite を使用
  • 詳細なリサーチ = /research - perplexity_research ツールではない
  • フォールバックの順序 - Search → Ask → WebSearch（最後の手段）

コメント

Markdown 対応