nexusfeed-ltl

nexusfeed-mcp

实时 LTL 货运燃油附加费率，以及美国各州 ABC 酒类许可证合规记录——通过模型上下文协议，以规范化、可验证的 JSON 格式提供给 AI Agent。

数据从承运商资费页面和各州 ABC 门户提取（这些页面由 JS 渲染，带有 CAPTCHA 和会话状态），原始 LLM 浏览无法在结构上访问这些页面。每个响应都包含一个 _verifiability 区块，其中包含提取时间戳、置信度评分和来源 URL，方便 Agent 在采取行动前评估数据质量。

工具

工具	描述
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。提供免费增值套餐（免费套餐每天 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 → 手动添加服务器：

仅 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 是规范来源——Agent 可以独立验证

使用示例

审计 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 或其值无效
“Could not reach API server”	未设置 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]。