念連 (Nia-Link) 🦞

Die Hochleistungs-Browser-Schnittstelle für KI-Agenten. „Höre den Puls des Webs, sieh die Seele der Daten.“ "Hear the pulse of the web, see the soul of the data."

中文 | English

Nia-Link ist eine Web Neuro-Link Engine, die speziell für KI-Agenten entwickelt wurde. Durch die native Unterstützung des Model Context Protocol (MCP) bietet es Claude Desktop – oder jeder anderen MCP-kompatiblen KI – einen zu 99 % zuverlässigen Webzugriff und Automatisierungsfunktionen.

Englische Dokumentation

🚀 Kernvorteile

1. Web Neuro-Link

Im Gegensatz zu herkömmlichen visuellen Scrapern hört Nia-Link direkt auf die Netzwerkimpulse des Browsers via CDP (Chrome DevTools Protocol). Wir warten nicht auf das Rendern der Seite – wir nehmen den Datenfluss wahr.

2. Action Map Registry

Ein Speicher-Hub mit einer Architektur für „zwischengespeicherte Semantik“. Liefert Aktionspläne für häufig besuchte Websites in 0,01 s und reduziert so wiederholte Rechenkosten um 90 %.

3. Vertrauen auf Unternehmensniveau

• 🔒 Snapshot-Verifizierung: Jede Extraktion ist mit einem Zeitstempel versehen und strukturell validiert.

• 🛡️ Sandbox-Isolierung: JavaScript wird isoliert ausgeführt, was die Sicherheit des Hosts gewährleistet.

• 📉 Token-optimiert: Die integrierte intelligente Filterung spart im Durchschnitt ca. 92 % des Kontextspeichers.

4. v0.9 Neue Funktionen

• 🔄 Website-Änderungserkennung (/v1/diff): Verfolgen Sie Inhaltsänderungen mit Unified Diffs

• 📋 Asynchrone Aufgabenwarteschlange (/v1/queue/*): Senden Sie Hintergrund-Scraping-Aufgaben

• ⚡ Ratenbegrenzung: Konfigurierbarer Token-Bucket-Ratenbegrenzer pro Schlüssel

• 🧪 Automatisierte Tests: 53 pytest-Tests, die API, Dienste und Authentifizierung abdecken

🛠️ Schnellstart

Anforderungen

• Python 3.10+

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

Installation

# 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

Server starten

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

# Or use Docker
docker compose up -d

Als MCP-Server ausführen

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Tests ausführen

pip install pytest
python -m pytest tests/ -v

📡 API-Referenz

Gesundheitsprüfung

curl http://localhost:8000/health

Webseite scrapen

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
  }'

Menschenähnliche Interaktion

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"
  }'

Website-Änderungserkennung (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"}'

Asynchrone Warteschlange (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"

MCP-Tools

⚙️ Umgebungsvariablen

Siehe .env.example für alle Optionen.

🐳 Docker

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

📊 Roadmap

• [x] v0.4: MCP-Protokollintegration

• [x] v0.5: Dashboard zur Visualisierung dynamischer Schwerkraftpartikel

• [x] v0.6: Motorische Nerven — Bézier-Kurven-Mausbahnen, humanisiertes Tipp-Jittern, Sitzungspersistenz

• [x] v0.7: Synaptische Brücke — MCP-Standardisierung, Trajektorien-Cloud, Proxy/Parallelität, Docker

• [x] v0.8: Neuro-Erweiterung — Diff-Dienst, asynchrone Warteschlange, Ratenbegrenzung, Proxy-Pool-Rotation, 53 automatisierte Tests

• [x] v0.9: Einreichung bei Smithery.ai & Glama-Ökosystem, Abrechnungs-/Nutzungslimits

Chinesische Dokumentation

🚀 Kernvorteile

1. Web Neuro-Link

Im Gegensatz zu herkömmlichen visuellen Scrapern hört Nia-Link direkt auf die Netzwerkimpulse des Browsers via CDP (Chrome DevTools Protocol). Wir warten nicht auf das Rendern der Seite – wir nehmen den Datenfluss wahr.

2. Action Map Registry

Ein Speicher-Hub mit einer Architektur für „zwischengespeicherte Semantik“. Liefert Aktionspläne für häufig besuchte Websites in 0,01 s und reduziert so wiederholte Rechenkosten um 90 %.

3. Vertrauen auf B2B-Niveau

• 🔒 Snapshot-Verifizierung: Jede Extraktion ist mit einem Zeitstempel versehen und strukturell validiert.

• 🛡️ Sandbox-Isolierung: JavaScript wird isoliert ausgeführt, was die Sicherheit des Hosts gewährleistet.

• 📉 Token-optimiert: Die integrierte intelligente Filterung spart im Durchschnitt ca. 92 % des Kontextspeichers.

4. v0.9 Neue Funktionen

• 🔄 Website-Änderungserkennung (/v1/diff): Verfolgen Sie Inhaltsänderungen mit Unified Diffs

• 📋 Asynchrone Aufgabenwarteschlange (/v1/queue/*): Senden Sie Hintergrund-Scraping-Aufgaben

• ⚡ Ratenbegrenzung: Konfigurierbarer Token-Bucket-Ratenbegrenzer pro Schlüssel

• 🧪 Automatisierte Tests: 53 pytest-Tests, die API, Dienste und Authentifizierung abdecken

🛠️ Schnellstart

Anforderungen

• Python 3.10+

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

Installation

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

# 2. 安裝瀏覽器
playwright install chromium

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

Server starten

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

# 或使用 Docker
docker compose up -d

Als MCP-Server ausführen

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Tests ausführen

pip install pytest
python -m pytest tests/ -v

📡 API-Nutzungsbeispiele

Gesundheitsprüfung

curl http://localhost:8000/health

Webseite scrapen

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
  }'

Menschenähnliche Interaktion

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"
  }'

Website-Änderungserkennung (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"}'

Asynchrone Warteschlange (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-Toolliste

⚙️ Umgebungsvariablen

Siehe .env.example

🐳 Docker-Bereitstellung

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

# 啟動
docker compose up -d

# 查看日誌
docker compose logs -f

📊 Taktischer Entwicklungsplan (Roadmap)

• [x] v0.4: Integration des MCP-Protokolls, Unterstützung für plattformübergreifende Aufrufe

• [x] v0.5: Dashboard zur Visualisierung dynamischer Schwerkraftpartikel

• [x] v0.6: Motorische Nervenrevolution — Bézier-Kurven-Mausbahnen, humanisiertes Tipp-Jittern, Sitzungspersistenz

• [x] v0.7: Synaptische Brücke — MCP-Standardisierung, Trajektorien-Cloud-Visualisierung, Proxy/Parallelität/Wiederholungsversuche, Docker

• [x] v0.8: Neuro-Erweiterung — Diff-Dienst, asynchrone Warteschlange, Ratenbegrenzung, Proxy-Pool-Rotation, 53 automatisierte Tests

• [x] v0.9: Einreichung bei Smithery.ai & Glama-Ökosystem, Abrechnungs-/Nutzungslimits

🔗 Nia-Link: Das sensorische Nervensystem für KI-Agenten

Nia-Link ist ein MCP-Server (Model Context Protocol), der speziell für große Sprachmodelle (LLMs) entwickelt wurde. Er verleiht führenden KI-Agenten wie Claude Opus 4.7 oder GPT-5.4 leistungsstarke Funktionen für Webnavigation, visuelle Wahrnehmung und das Umgehen von Anti-Scraping-Maßnahmen.

🚀 Schnelle Bereitstellung (Railway One-Click)

Wir empfehlen die Verwendung von Railway für die Bereitstellung, um die stabilste Laufzeitumgebung und ein minimalistisches DevOps-Erlebnis zu erhalten.

1. One-Click-Bereitstellung: Klicken Sie auf die Schaltfläche „Deploy on Railway“ oben.

2. Variablen konfigurieren: Geben Sie auf der Bereitstellungsseite Ihre Oxylabs-Authentifizierungsinformationen ein (siehe unten).

3. Verbindung abschließen: Geben Sie die generierte URL in die Konfiguration Ihres KI-Agenten ein.

Warum Railway? Moderne Architekten sollten sich auf die KI-Logik konzentrieren, nicht auf die Serververwaltung. Für eine tiefgehende Analyse der architektonischen Vorteile von Railway lesen Sie meinen Artikel: Legen Sie SSH und Nginx beiseite: Warum moderne Architekten die Infrastruktur Railway überlassen.

🛠️ Konfiguration der Umgebungsvariablen (Environment Variables)

Um sicherzustellen, dass Nia-Link Cloudflare oder Captcha-Blockaden ignorieren kann, integriert dieses Projekt nativ die Oxylabs Web Unblocker-Technologie.

📚 Technische Einblicke (Technical Insights)

Nia-Link ist mehr als nur Code; es repräsentiert eine völlig neue Agent-First-Philosophie der Datengewinnung. Wenn Sie tiefer in die zugrunde liegenden Prinzipien eintauchen möchten, empfehle ich die Lektüre der folgenden technischen Kolumnen:

1. Durchbrechen des Wahrnehmungsengpasses von KI

Untersuchung, warum herkömmliche Playwright-Skripte im Jahr 2026 nicht mehr anwendbar sind und wie man durch API-First hohe Token-Kosten einspart. 👉 Das Ende des API-Token-Verbrennungsofens: Best Practices für KI-Agenten zur Überwindung von Anti-Scraping-Systemen

2. Moderne Bereitstellungsstrategien

Analyse, wie ein Ein-Personen-Unternehmen Cloud-Infrastruktur nutzen kann, um 99,9 % Systemstabilität zu erreichen und gleichzeitig die Wartungskosten zu minimieren. 👉 Legen Sie SSH und Nginx beiseite: Die Kunst der Subtraktion für moderne Architekten

🤝 Beitrag und Unterstützung

Wenn Sie feststellen, dass Nia-Link Ihrem KI-Agenten geholfen hat, eine breitere Welt zu sehen, geben Sie uns bitte einen ⭐ Star zur Unterstützung!

Powered by: Oxylabs & Railway

Created with soul by Nia & Boss. 🦞 Maintainer: Dieses Projekt wird aktiv von Gene als Teil des Nia-Automatisierungs-Ökosystems gepflegt.