Parcel Pilot MCP

Parcel Pilot MCP utiliza Playwright Chromium para guardar el estado de inicio de sesión de tu navegador personal y, a través de MCP, proporciona los datos de los paquetes a tu cliente de IA. Puedes preguntar cosas como:

查询我所有待收货快递
今天有没有已经签收的包裹？
帮我查一下上周淘宝订单的物流进度

Es adecuado para uso personal y puede ejecutarse localmente en Mac o en tu propio servidor Linux. No es una API oficial de Taobao, JD o Cainiao.

Funcionalidades destacadas

Related MCP server: Parcel MCP Server

Ejemplo de respuesta

{
  "packages": [
    {
      "id": "taobao-1234567890",
      "source": "taobao",
      "title": "USB-C 数据线",
      "status": "in_transit",
      "carrier": "菜鸟",
      "trackingNumber": "YT123456789CN",
      "lastEvent": "运输中预计今天送达",
      "updatedAt": "2026-05-08T09:00:00.000+08:00"
    }
  ]
}

Estado de la plataforma

Las páginas de los sitios de comercio electrónico cambian con frecuencia, por lo que los analizadores requieren mantenimiento según la página real.

Inicio rápido

npm install
npm run build

Playwright instalará Chromium durante npm install. Si faltan dependencias del sistema en Linux, ejecuta:

npx playwright install-deps chromium

Copia .env.example a .env:

PACKAGE_ASSISTANT_DATA_DIR=./data
PACKAGE_ASSISTANT_PROFILE_DIR=./browser-profiles
PACKAGE_ASSISTANT_ARTIFACT_DIR=./var
PACKAGE_ASSISTANT_HEADLESS=true
PACKAGE_ASSISTANT_TIMEZONE=Asia/Shanghai

Para el primer inicio de sesión en macOS, se recomienda abrir el navegador visible:

PACKAGE_ASSISTANT_HEADLESS=false node dist/cli/open-login-browser.js taobao

Tras escanear el código y completar la verificación, sincroniza y consulta:

node dist/cli/call-tool.js sync_packages '{"source":"taobao"}'
node dist/cli/call-tool.js get_my_packages
node dist/cli/call-tool.js track_package '{"packageId":"taobao-ORDER_ID"}'

Configuración del cliente MCP

Cualquier cliente que soporte MCP stdio puede configurarse así:

{
  "mcpServers": {
    "parcel-pilot": {
      "command": "node",
      "args": ["/absolute/path/parcel-pilot-mcp/dist/server.js"],
      "env": {
        "PACKAGE_ASSISTANT_DATA_DIR": "/absolute/path/parcel-pilot-mcp/data",
        "PACKAGE_ASSISTANT_PROFILE_DIR": "/absolute/path/parcel-pilot-mcp/browser-profiles",
        "PACKAGE_ASSISTANT_ARTIFACT_DIR": "/absolute/path/parcel-pilot-mcp/var",
        "PACKAGE_ASSISTANT_HEADLESS": "true",
        "PACKAGE_ASSISTANT_TIMEZONE": "Asia/Shanghai"
      }
    }
  }
}

Proceso de inicio de sesión inicial

1. Pide al cliente de IA que llame a login_taobao, login_jd o login_cainiao.

2. Abre la ruta screenshotPath devuelta, generalmente bajo var/login/.

3. Escanea el código QR con tu móvil para iniciar sesión.

4. Completa manualmente captchas, SMS, deslizadores o avisos de seguridad.

5. Llama a sync_packages.

6. A partir de ahora, puedes preguntar get_my_packages, track_package o get_delivered_today.

Si la captura del código QR caduca rápido o la página requiere interacción, puedes abrir un navegador visible mediante noVNC, reenvío X por SSH o sesión de escritorio:

PACKAGE_ASSISTANT_HEADLESS=false npm run dev

Herramientas MCP

Despliegue en servidor Linux privado

Forma recomendada:

• Docker y Docker Compose.

• Acceso solo mediante SSH.

• MCP iniciado por el cliente de IA en la misma máquina vía stdio, o usado vía SSH/VPN.

• No exponer una interfaz HTTP pública sin autenticación.

Despliegue desde la máquina local:

./scripts/aliyun-deploy.sh user@your-server:/opt/parcel-pilot-mcp

Ejecuta el inicio de sesión y sincronización inicial en el servidor:

cd /opt/parcel-pilot-mcp
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_taobao
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_jd
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_cainiao
docker compose run --rm -T package-assistant node dist/cli/call-tool.js sync_packages

Si necesitas un navegador remoto interactivo:

cd /opt/parcel-pilot-mcp
docker compose run --rm --service-ports package-assistant ./scripts/remote-browser.sh taobao
ssh -N -L 6080:127.0.0.1:6080 user@your-server

Luego abre:

http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

Llama al MCP del servidor vía SSH:

{
  "mcpServers": {
    "parcel-pilot": {
      "command": "ssh",
      "args": [
        "user@your-server",
        "cd /opt/parcel-pilot-mcp && docker compose run --rm -T package-assistant"
      ]
    }
  }
}

Modelo de seguridad

Trata browser-profiles/ como un "navegador ya iniciado sesión" y protégelo.

• No subas data/, var/, browser-profiles/, .env o tmp-login/ a repositorios.

• No expongas el proceso MCP, noVNC o navegadores de login temporal a la red pública.

• Recomendado solo para tus propias cuentas y máquinas bajo tu control.

• Quien acceda al perfil del navegador podría ver pedidos, logística, direcciones y páginas de cuenta.

• Este proyecto no se salta captchas, deslizadores, SMS o controles de riesgo de la plataforma.

• Se recomienda desactivar pagos sin contraseña, cobros automáticos o pedidos rápidos para reducir riesgos en caso de abuso del estado de sesión.

Desarrollo

npm test
npm run build

Comandos locales comunes:

npm run call-tool -- get_my_packages
npm run call-tool -- sync_packages '{"source":"taobao"}'

Hoja de ruta

• Mejorar selectores de JD y Cainiao con más páginas de cuentas reales.

• Añadir anonimización opcional para campos sensibles como nombres de productos o direcciones.

• Añadir diagnóstico de salud de proveedores para estados de sesión caducados, páginas de riesgo o páginas vacías.

• Añadir ejemplos de configuración para clientes MCP como Claude Desktop, Codex, etc.

Licencia

MIT