念連 (Nia-Link) 🦞

La interfaz de navegador de alto rendimiento para agentes de IA. 「聽見網頁的脈搏，看見資料的靈魂。」 "Escucha el pulso de la web, mira el alma de los datos."

中文 | English

Nia-Link es un motor de neuro-enlace web diseñado específicamente para agentes de IA. Al adoptar de forma nativa el Protocolo de Contexto de Modelo (MCP), proporciona a Claude Desktop —o a cualquier IA compatible con MCP— acceso web y capacidades de automatización con un 99% de fiabilidad.

Documentación en inglés

🚀 Ventajas principales

1. Neuro-enlace web

A diferencia de los scrapers visuales tradicionales, Nia-Link escucha directamente los pulsos de red del CDP (Chrome DevTools Protocol) del navegador. No esperamos a que la página se renderice; percibimos el flujo de datos.

2. Registro de mapas de acción

Un centro de memoria con arquitectura de "semántica en caché". Entrega mapas de acción en 0,01s para sitios visitados frecuentemente, reduciendo los costes de computación repetida en un 90%.

3. Confianza de nivel empresarial

• 🔒 Instantánea verificada: Cada extracción tiene marca de tiempo y validación estructural.

• 🛡️ Aislamiento en sandbox: JavaScript se ejecuta de forma aislada, garantizando la seguridad del host.

• 📉 Optimización de tokens: El filtrado inteligente integrado ahorra una media del 92% de espacio de contexto.

4. Nuevas funciones de la v0.9

• 🔄 Detección de cambios en sitios web (/v1/diff): Rastrea cambios de contenido con diffs unificados.

• 📋 Cola de tareas asíncronas (/v1/queue/*): Envía tareas de scraping en segundo plano.

• ⚡ Limitación de tasa: Limitador de tasa de cubo de tokens configurable por clave.

• 🧪 Pruebas automatizadas: 53 pruebas pytest que cubren API, servicios y autenticación.

🛠️ Inicio rápido

Requisitos

• Python 3.10+

• Playwright (pip install playwright && playwright install chromium)

Instalación

# 1. Install dependencies
pip install -r requirements.txt

# 2. Install browser
playwright install chromium

# 3. Configure environment
cp .env.example .env
# Edit .env to set your API_KEYS

Iniciar el servidor

# Development mode
uvicorn app.main:app --reload --port 8000

# Or use Docker
docker compose up -d

Ejecutar como servidor MCP

Añadir a su claude_desktop_config.json:

{
  "mcpServers": {
    "nia-link": {
      "command": "python",
      "args": ["/path/to/Nia-Link/app/mcp_server.py"]
    }
  }
}

Ejecutar pruebas

pip install pytest
python -m pytest tests/ -v

📡 Referencia de API

Comprobación de estado

curl http://localhost:8000/health

Extraer una página web

curl -X POST http://localhost:8000/v1/scrape \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "markdown",
    "mode": "fast",
    "extract_actions": true
  }'

Interacción similar a la humana

curl -X POST http://localhost:8000/v1/interact \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "actions": [
      {"type": "click", "selector": "#search-btn"},
      {"type": "fill", "selector": "#search-input", "text": "Hello world"},
      {"type": "wait", "ms": 2000}
    ],
    "account_id": "my-session-1"
  }'

Detección de cambios en sitios web (v0.9)

curl -X POST http://localhost:8000/v1/diff \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Cola asíncrona (v0.9)

# Submit task
curl -X POST http://localhost:8000/v1/queue/submit \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Poll result
curl http://localhost:8000/v1/queue/{task_id} \
  -H "Authorization: Bearer your-api-key"

Herramientas MCP

⚙️ Variables de entorno

Consulte .env.example para ver todas las opciones.

🐳 Docker

docker build -t nia-link .
docker compose up -d
docker compose logs -f

📊 Hoja de ruta

• [x] v0.4: Integración del protocolo MCP

• [x] v0.5: Panel de visualización de partículas de gravedad dinámica

• [x] v0.6: Nervio motor — Trayectorias de ratón con curvas de Bézier, fluctuación de escritura humanizada, persistencia de sesión

• [x] v0.7: Puente sináptico — Estandarización MCP, nube de trayectorias, proxy/concurrencia, Docker

• [x] v0.8: Neuro-expansión — Servicio Diff, cola asíncrona, limitación de tasa, rotación de pool de proxies, 53 pruebas automatizadas

• [x] v0.9: Envío a Smithery.ai y al ecosistema Glama, límites de facturación/uso

Documentación en chino

🚀 核心優勢

1. 網頁神經連結 (Web Neuro-Link)

不同於傳統視覺爬蟲，Nia-Link 直接監聽瀏覽器底層的 CDP (Chrome DevTools Protocol) 網絡脈衝。我們不等待頁面渲染，我們感知數據流動。

2. 行動地圖註冊表 (Action Map Registry)

具備「緩存語意」架構的記憶中樞。針對常用網站提供秒級（0.01s）的行動地圖回傳，將重複運算成本降低 90%。

3. B2B 級別的可信賴感

• 🔒 快照驗證: 每一筆提取資料皆附帶時間戳記與結構驗證。

• 🛡️ 沙箱隔離: 在隔離環境執行 JavaScript，確保宿主機絕對安全。

• 📉 Token 優化: 內建智慧過濾，平均節省 92% 的上下文空間。

4. v0.9 新功能

• 🔄 網站變更偵測 (/v1/diff): 追蹤內容變更，回傳 unified diff

• 📋 非同步任務佇列 (/v1/queue/*): 提交背景爬取任務

• ⚡ 速率限制: 可配置的每 API Key Token Bucket 限流器

• 🧪 自動化測試: 53 個 pytest 測試覆蓋 API、服務與認證

🛠️ 快速開始

環境需求

• Python 3.10+

• Playwright (pip install playwright && playwright install chromium)

安裝

# 1. 安裝依賴
pip install -r requirements.txt

# 2. 安裝瀏覽器
playwright install chromium

# 3. 配置環境變數
cp .env.example .env
# 編輯 .env 設定您的 API_KEYS

啟動服務

# 開發模式
uvicorn app.main:app --reload --port 8000

# 或使用 Docker
docker compose up -d

作為 MCP Server 執行

在您的 claude_desktop_config.json 中加入：

{
  "mcpServers": {
    "nia-link": {
      "command": "python",
      "args": ["/path/to/Nia-Link/app/mcp_server.py"]
    }
  }
}

運行測試

pip install pytest
python -m pytest tests/ -v

📡 API 使用範例

健康檢查

curl http://localhost:8000/health

爬取網頁

curl -X POST http://localhost:8000/v1/scrape \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "markdown",
    "mode": "fast",
    "extract_actions": true
  }'

擬人化交互

curl -X POST http://localhost:8000/v1/interact \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "actions": [
      {"type": "click", "selector": "#search-btn"},
      {"type": "fill", "selector": "#search-input", "text": "Hello world"},
      {"type": "wait", "ms": 2000}
    ],
    "account_id": "my-session-1"
  }'

網站變更偵測 (v0.9)

curl -X POST http://localhost:8000/v1/diff \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

非同步佇列 (v0.9)

# 提交任務
curl -X POST http://localhost:8000/v1/queue/submit \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# 查詢結果
curl http://localhost:8000/v1/queue/{task_id} \
  -H "Authorization: Bearer your-api-key"

MCP 工具列表

⚙️ 環境變數

詳見 .env.example

🐳 Docker 部署

# 建構映像
docker build -t nia-link .

# 啟動
docker compose up -d

# 查看日誌
docker compose logs -f

📊 戰術開發計畫 (Roadmap)

• [x] v0.4: 整合 MCP 協議，支援跨平台調用

• [x] v0.5: 動態引力粒子視覺化儀表板

• [x] v0.6: 運動神經革命 — 貝茲曲線滑鼠軌跡、擬人化打字抖動、Session 持久化

• [x] v0.7: 突觸橋接 — MCP 標準化、軌跡雲視覺化、Proxy/併發/重試、Docker

• [x] v0.8: 神經擴展 — Diff 服務、非同步佇列、速率限制、代理池輪換、53 個自動化測試

• [x] v0.9: 提交至 Smithery.ai 與 Glama 生態圈、計費/用量限制

🔗 Nia-Link: The Sensory Nervous System for AI Agents

Nia-Link 是一個專為大語言模型（LLM）打造的 MCP (Model Context Protocol) 伺服器。它能賦予如 Claude Opus 4.7 或 GPT-5.4 等頂尖 AI Agent 強大的網頁導航、視覺感知與反爬蟲突破能力。

🚀 快速部署 (Railway One-Click)

我們建議使用 Railway 進行部署，以獲得最穩定的運行環境與極簡的 DevOps 體驗。

1. 一鍵部署：點擊上方「Deploy on Railway」按鈕。

2. 配置變數：在部署頁面填入你的 Oxylabs 認證資訊（見下方說明）。

3. 完成連接：將產出的 URL 填入你的 AI Agent 配置中。

為什麼選擇 Railway？ 現代架構師應專注於 AI 邏輯而非管理伺服器。關於 Railway 的深度架構優勢，請參閱我的分析文章：放下你的 SSH 與 Nginx：為什麼現代架構師都把基礎設施交給 Railway。

🛠️ 環境變數配置 (Environment Variables)

為了確保 Nia-Link 能無視 Cloudflare 或驗證碼阻擋，本專案原生整合了 Oxylabs Web Unblocker 技術。

📚 技術深度導讀 (Technical Insights)

Nia-Link 不僅僅是代碼，它代表了一種全新的 Agent-First 資料獲取哲學。如果你想深入了解底層原理，推薦閱讀以下技術專欄：

1. 突破 AI 的感知瓶頸

探討為何傳統的 Playwright 腳本在 2026 年已不再適用，以及如何透過 API-First 節省高昂的 Token 成本。 👉 終結 API Token 燃燒爐：AI Agent 突破反爬蟲系統的最佳實踐

2. 現代化部署策略

分析一人公司如何利用雲端基礎設施實現 99.9% 的系統穩定度，同時將維護成本降至最低。 👉 放下你的 SSH 與 Nginx：現代架構師的減法藝術

🤝 貢獻與支持

如果你發現 Nia-Link 幫助你的 AI Agent 看見了更廣闊的世界，請給予我們一顆 ⭐ Star 支持！

Powered by: Oxylabs & Railway

Created with soul by Nia & Boss. 🦞 Maintainer: This project is actively maintained by Gene as part of the Nia automation ecosystem.