graphhopper-automation

graphhopper-automation skill の概要

graphhopper-automation でできること

graphhopper-automation は、Composio の Rube MCP server を通じて GraphHopper 関連のワークフロー自動化を実行するための Claude skill です。GraphHopper のツール呼び出しを固定的に書き込むのではなく、まず現在の Rube tool schema を検出し、GraphHopper connection を確認したうえで、返された tool 名と入力フィールドに沿って適切な操作を実行するようエージェントに指示します。

ルーティング、距離や移動時間の計算、経路計画、物流の検証、その他 GraphHopper を利用するタスクを、毎回 Composio の toolkit schema を手作業で確認せずに AI agent に任せたい場合に、この graphhopper-automation skill が役立ちます。

向いているユーザーとワークフロー

graphhopper-automation skill は、Claude やその他の MCP 対応クライアントをすでに使っていて、エージェントのワークフロー内で GraphHopper actions を扱いたい開発者、運用チーム、物流アナリスト、AI workflow builder に特に向いています。たとえば次のようなタスクに適しています。

• 構造化された住所や座標から、ルーティングまたは移動時間のリクエストを準備する
• Composio から公開されている利用可能な GraphHopper actions を確認する
• GraphHopper data を使う反復可能な workflow prompt を作成する
• GraphHopper の結果をスプレッドシート、CRM、配車、レポート作成のワークフローと組み合わせる

一方で、地図 UI 上で一度だけ手動で経路を調べたいだけなら、あまり適していません。

主な差別化ポイント: 先に schema を検出する

graphhopper-automation の主な価値は、GraphHopper commands の静的な一覧ではありません。中心となる流れは、まず Rube tools を検索し、現在の schema を確認し、GraphHopper connection をチェックしてから tool を呼び出すことです。これは、MCP tool の名前、フィールド、必須パラメーターが変わる可能性があるため重要です。この skill は、古い前提に基づく呼び出し失敗を減らします。

導入前に必要なもの

Rube に接続できる MCP client、RUBE_SEARCH_TOOLS へのアクセス、そして RUBE_MANAGE_CONNECTIONS で管理されている有効な GraphHopper connection が必要です。上流の skill には SKILL.md が 1 つあるだけで、補助スクリプトはありません。そのため、パッケージ化された CLI や SDK wrapper ではなく、prompt-driven automation として使う前提で考えてください。

graphhopper-automation skill の使い方

graphhopper-automation のインストール前提

対応する skills-enabled 環境に skill をインストールします。例:

npx skills add ComposioHQ/awesome-claude-skills --skill graphhopper-automation

次に、クライアント設定で Rube MCP を server として追加します。

https://rube.app/mcp

MCP server が利用可能になったら、RUBE_SEARCH_TOOLS が応答することを確認します。続いて、toolkit に graphhopper を指定して RUBE_MANAGE_CONNECTIONS を使い、connection が ACTIVE でない場合は返された認可フローを完了します。

唯一のソースファイルから確認する

まず composio-skills/graphhopper-automation/SKILL.md を読んでください。この skill には README.md、scripts/、references/、resources/ フォルダーがないため、運用上のガイダンスはそのファイルに集約されています。特に次の点に注意してください。

• Rube MCP と GraphHopper connection status に関する前提条件
• 実行前に RUBE_SEARCH_TOOLS を呼び出すという指示
• 検出、connection check、tool call の基本的な workflow pattern
• 特定のユースケースを tool discovery に渡す例

この点が重要なのは、この skill が同梱ドキュメントではなく、live schema discovery に依存しているためです。

ざっくりした目的を使える prompt に変える

弱い prompt:

Find the best route for my deliveries.

graphhopper-automation を使う場合のより強い prompt:

Use graphhopper-automation for Workflow Automation. First call RUBE_SEARCH_TOOLS for a GraphHopper delivery routing or route optimization task and inspect the returned schema. Confirm the GraphHopper connection is active. Then plan a workflow for 8 stops starting from 40.7128,-74.0060, ending at 40.7306,-73.9352, using car travel mode if supported. If optimization is not available in the discovered tools, explain the closest supported alternative before calling anything.

このように書くと、座標、タスク種別、制約、代替時の動作、実行前に現在の tool schema を検証する許可がエージェントに与えられるため、結果の精度が上がります。

実用的なワークフローのコツ

できるだけ座標を提供してください。利用可能な tool が緯度・経度を期待している場合、住所だけだと geocoding の曖昧さが生じます。移動モード、始点と終点、最適化の希望、時間枠、回避エリア、車両条件などは、結果に影響する場合だけ明記します。精度が重要な場合は、最終的な呼び出しの前に、検出された tool slug と必須フィールドをエージェントに表示させてください。

最初の tool search が広すぎる場合は、“GraphHopper matrix travel times for 20 coordinates” や “GraphHopper isochrone from one coordinate” のように、より絞り込んだユースケースで RUBE_SEARCH_TOOLS を再実行します。

graphhopper-automation skill FAQ

graphhopper-automation は GraphHopper API client ですか？

直接の GraphHopper API client ではありません。graphhopper-automation は、Claude が Rube MCP 経由で Composio の GraphHopper toolkit を使うための agent skill です。GraphHopper の API documentation や SDKs を置き換えるものではありません。利用可能な GraphHopper tools を検出して呼び出すための MCP workflow layer と考えるのが適切です。

Claude に GraphHopper request を頼むだけではだめですか？

一般的な prompt だけだと、存在しないフィールド名を作ったり、古い API 形状を前提にしたりする可能性があります。この skill の主なガードレールは、実行前に RUBE_SEARCH_TOOLS を呼び出し、エージェントが現在の tool slugs、schemas、注意点を確認できるようにすることです。そのため、静的な「GraphHopper の呼び出しを書いて」という prompt よりも、実際の workflow automation では信頼しやすくなります。

graphhopper-automation skill は初心者にも使いやすいですか？

MCP client がすでに設定済みで、GraphHopper connection の認可リンクをたどれるなら、初心者にも扱いやすい skill です。一方で、MCP servers を設定したことがない、クライアントが tools に対応しているか分からない、あるいは agent workflow ではなく視覚的な route-planning application が必要なユーザーにはあまり向きません。

使わないほうがよいケースは？

オフライン routing、安定性が保証されたローカル API wrapper、テスト付きの完全にスクリプト化された pipeline が必要な場合は、この skill を使わないほうがよいでしょう。上流の skill に含まれているのはガイダンスであり、実行可能な補助コードではありません。また、現在の Composio toolkit に公開されていない GraphHopper 機能が必要な場合も避けるべきです。エージェントは実行を約束する前に、tool discovery で利用可否を確認する必要があります。

graphhopper-automation skill を改善する方法

graphhopper-automation の入力を改善する

品質を最も大きく左右するのは、タスクの切り出し方です。作業の種類、場所、単位、移動モード、必要な出力形式、許容できる代替案を含めてください。例:

Search current GraphHopper tools for matrix travel times. Use these 12 latitude/longitude pairs, return a CSV-style table of pairwise durations in minutes, and do not guess missing coordinates.

これは “calculate distances” よりも優れています。どの GraphHopper capability を探すべきか、どの data shape を使うべきか、どの形式で結果を返すべきかをエージェントに伝えられるためです。

よくある失敗パターンに注意する

よくある問題には、GraphHopper connection が inactive、tool discovery の省略、曖昧な住所、必須 schema fields の不足、routing や matrix calculation しか使えないのに optimization に対応していると思い込む、といったものがあります。良い graphhopper-automation guide prompt では、必ず「まず tools を検出し、connection status を確認し、必須フィールドを確認してから実行する」と明示するべきです。

最初の結果のあとに反復する

最初の出力後は、検出された schema と元の制約に照らして結果を比較するようエージェントに依頼します。役立つ follow-up の例:

• “Show which input fields were required versus optional.”
• “Rerun the tool search for route optimization specifically.”
• “Convert the result into a dispatch-ready table.”
• “Explain any GraphHopper limitation or missing parameter that affected the result.”

こうすることで、一度きりの呼び出しを、信頼できるワークフローに変えられます。

チーム利用向けに skill を拡張する

チームで graphhopper-automation を継続的に使う場合は、よくあるタスク向けの社内例を追加してください。たとえば、route planning、matrix calculations、depot-to-stop analysis、territory checks などです。好みの座標形式、出力テンプレート、connection troubleshooting notes を skill の近くに保存しておくとよいでしょう。上流リポジトリは意図的に最小構成になっているため、ローカルの例を追加するだけでも、Rube MCP discovery pattern の中核を変えずに一貫性を大きく高められます。