nexusfeed-ltl

nexusfeed-mcp

リアルタイムのLTL貨物燃料サーチャージ率と、米国各州のABC酒類販売免許コンプライアンス記録を、Model Context Protocol経由でAIエージェント向けに、正規化され検証可能なJSONとして提供します。

生のLLMによる閲覧では構造上アクセスできない運送業者の運賃表ページや州のABCポータル（JavaScriptレンダリング、CAPTCHA、セッション状態）からデータを抽出します。すべての応答には、抽出タイムスタンプ、信頼度スコア、ソースURLを含む_verifiabilityブロックが含まれるため、エージェントは行動する前にデータ品質を評価できます。

ツール

ツール	説明
ltl_get_fuel_surcharge	ODFL、Saia、Estes、ABF、R+L、TForce、XPO、SEFL、Averittの週間燃料サーチャージ率。DOEのディーゼル価格と最大5年分の履歴も取得できます
ltl_list_carriers	運送業者の対応情報（SCACコード、更新スケジュール、抽出方法）
abc_search_licenses	商号、所有者、住所からCA、TX、NY、FLの免許データベースを検索します
abc_lookup_license	州が発行した免許番号を指定して、特定時点の免許状態を確認します
abc_list_states	州ごとの対応状況、遅延時間、CAPTCHA要件

ワークフロープロンプト

プロンプト	説明
freight_audit_workflow	公開された運送業者の運賃表に照らしてLTL請求書を監査する複数ステップのワークフロー
license_compliance_check	販売業者への発注、保険の契約、または加盟店のオンボーディング前にコンプライアンスを確認します

APIアクセスの取得

RapidAPIから登録して、X-API-Keyを取得してください。フリーミアムプランを利用できます（1日あたり10リクエストまで無料）。

製品	RapidAPIの掲載ページ
LTL Fuel Surcharge	rapidapi.com/ladourv/api/ltl-fuel-surcharge-api
ABC License Compliance	rapidapi.com/ladourv/api/abc-license-compliance-api

インストール

pip install nexusfeed-mcp
# or with uv/uvx (no install needed):
uvx nexusfeed-mcp

設定

export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_here

実行（stdio）

# LTL tools only — 3 tools, 1 prompt
nexusfeed-ltl

# ABC tools only — 3 tools, 1 prompt
nexusfeed-abc

# All tools — 5 tools, 2 prompts
nexusfeed-mcp

Claude Desktopの設定

LTL燃料サーチャージのみ：

{
  "mcpServers": {
    "nexusfeed-ltl": {
      "command": "uvx",
      "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

ABC免許コンプライアンスのみ：

{
  "mcpServers": {
    "nexusfeed-abc": {
      "command": "uvx",
      "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

すべてのツール：

{
  "mcpServers": {
    "nexusfeed-mcp": {
      "command": "uvx",
      "args": ["nexusfeed-mcp"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cline（VS Code）の設定

Clineの設定 → MCP Servers → Add Server manuallyを開きます：

LTLのみ：

{
  "nexusfeed-ltl": {
    "command": "uvx",
    "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
    "env": {
      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
      "MCP_API_KEY": "sk_live_your_key_here"
    }
  }
}

ABCのみ：

{
  "nexusfeed-abc": {
    "command": "uvx",
    "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
    "env": {
      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
      "MCP_API_KEY": "sk_live_your_key_here"
    }
  }
}

Streamable HTTP（Smithery／リモートクライアント）

サーバー	URL
LTLツール	https://api.nexusfeed.dev/mcp-ltl/
ABCツール	https://api.nexusfeed.dev/mcp-abc/

すべてのリクエストにX-API-Keyヘッダーを指定してください。サーバーメタデータ（認証不要）：

https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json

検証可能性

すべてのツールの応答には、次の情報が含まれます：

"_verifiability": {
  "source_timestamp": "2026-04-05T09:00:00Z",
  "extraction_confidence": 0.97,
  "raw_data_evidence_url": "https://odfl.com/...",
  "extraction_method": "api_mirror",
  "data_freshness_ttl_seconds": 604800
}

• コンプライアンス上重要な判断にデータを使用するには、extraction_confidence >= 0.90が必要です
• source_timestampがdata_freshness_ttl_seconds以内であれば、データはキャッシュから取得された最新のものです
• raw_data_evidence_urlは正規のソースです。エージェントは独自に検証できます

使用例

LTL貨物の請求書を監査する：

Use the freight_audit_workflow prompt with carrier="ODFL", invoice_date="2026-04-01",
invoiced_fuel_surcharge_pct="23.5" to check whether the billed rate matches the
published tariff.

販売業者との取引前に酒類販売免許を確認する：

Use abc_search_licenses with state="CA" and trade_name="Total Wine" to check
current license status, then abc_lookup_license for the full record with suspension history.

トラブルシューティング

症状	対処方法
すべての呼び出しで401が返る	MCP_API_KEYが設定されていないか、無効です
「APIサーバーに到達できません」	MCP_API_BASE_URLが設定されていません。https://api.nexusfeed.devに設定してください
TXエンドポイントが503を返す	TX TABCではサーバー側で2Captchaの設定が必要です。代わりにCA、NY、またはFLを使用してください
extraction_confidence < 0.90	データ品質が低下しています。raw_data_evidence_urlから個別に検証してください

ライセンス

クライアントコード（このリポジトリ）：MIT。 LICENSEを参照してください。

NexusFeedバックエンドサービス（https://api.nexusfeed.dev）：商用。 上記のMITライセンスが適用されるのは、このリポジトリのPythonクライアントラッパーのみです。データサービスを利用する権利は付与されません。データサービスには有料のAPIキーが必要であり、別途定められた利用規約が適用されます。エンタープライズ向けのSLAおよびライセンスについては、[email protected]までお問い合わせください。