nexusfeed-mcp

Name: nexusfeed-mcp
Author: NexusFeed

PyPI version Python 3.12+ License: MIT

Актуальные ставки топливных надбавок для LTL-перевозок и записи о соответствии лицензий на алкоголь ABC в штатах США — предоставляются в виде нормализованного, верифицируемого JSON для ИИ-агентов через протокол Model Context Protocol.

Данные извлекаются со страниц тарифов перевозчиков и порталов ABC штатов (с использованием JS-рендеринга, обхода CAPTCHA и сессионных состояний), которые структурно недоступны для обычного парсинга LLM. Каждый ответ включает блок _verifiability — временную метку извлечения, показатель достоверности и исходный URL — чтобы агенты могли оценить качество данных перед принятием решений.

Инструменты

Инструмент	Описание
`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

Related MCP server: us-legal-mcp

Рабочие сценарии (Workflow Prompts)

Промпт	Описание
`freight_audit_workflow`	Многоэтапный аудит счетов LTL-перевозок на соответствие опубликованным тарифам перевозчиков
`license_compliance_check`	Проверка соответствия требованиям перед заказом у дистрибьютора, оформлением страховки или регистрацией продавца

Получение доступа к API

Подпишитесь через RapidAPI, чтобы получить ваш X-API-Key. Доступны Freemium-планы (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"
    }
  }
}

Потоковый 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` не задан или недействителен
"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-ключа и регулируется отдельными Условиями использования (Terms of Service). Свяжитесь с ops@nexusfeed.dev для получения корпоративного SLA и лицензирования.

nexusfeed-mcp

nexusfeed-mcp

Инструменты

Рабочие сценарии (Workflow Prompts)

Получение доступа к API

Установка

Настройка

Запуск (stdio)

Конфигурация Claude Desktop

Конфигурация Cline (VS Code)

Потоковый HTTP (Smithery / удаленные клиенты)

Верификация

Пример использования

Устранение неполадок

Лицензия

Resources

Tools

Latest Blog Posts

MCP directory API