What is Hermes Agent?

Hermes Agent is an open-source, MIT-licensed, self-hosted AI agent built by Nous Research. It runs as a terminal and desktop application and includes persistent memory, a self-improving skills system, and integrations with communication platforms including Telegram, Discord, Slack, WhatsApp and Signal.

Do I need to use Nous Portal to run Hermes Agent?

No. Hermes Agent can switch between model backends including Nous Portal, OpenRouter, OpenAI and custom endpoints.

Why not just use Hermes's built-in web_extract tool?

Hermes's built-in web_extract tool works for ordinary pages, but its output can be truncated and JavaScript-heavy pages may require browser automation. Integrating Nstproxy Crawl provides JavaScript rendering and proxy-backed access through a single crawl API call.

Does this integration use Nstproxy Crawl's site-level crawling, or just single pages?

The integration in this guide uses Nstproxy Crawl's single-page scrape endpoint. Site-level crawling uses a separate endpoint and should be configured with explicit maximum depth and page limits.

Where do I put my Nstproxy API key?

Store the Nstproxy API key in an environment variable such as NSTPROXY_API_KEY instead of hardcoding it into plugin files or shared configuration.

Can Hermes Agent call Nstproxy Crawl through MCP instead of a plugin?

Hermes Agent supports MCP servers, but Nstproxy Crawl is currently exposed through a REST API. A custom Hermes plugin is therefore the direct integration method described in this guide, although an MCP wrapper could also be built around the REST API.

What happens if the crawl request fails or times out?

The integration should check the Crawl API response fields and return a structured failure response. Production implementations should also handle network errors such as request timeouts and connection failures.

Does this replace Hermes's browser automation tools entirely?

No. Hermes browser automation remains appropriate for interactive tasks such as clicking, scrolling and filling out forms. Nstproxy Crawl is better suited to retrieving and transforming page content for the agent to read.

Hermes Agent: Nó là gì & Cách sử dụng nó với Nstproxy Crawl

TL;DR

Hermes Agent là AI agent mã nguồn mở, cấp giấy phép MIT, tự lưu trữ của Nous Research — một ứng dụng terminal và desktop có bộ nhớ lâu dài, hệ thống kỹ năng tự cải thiện và hỗ trợ cho Telegram, Discord, Slack, WhatsApp, Signal và CLI.
Nó đi kèm với hơn 70 công cụ tích hợp sẵn, bao gồm web_search và web_extract, và có thể được mở rộng theo hai cách: kết nối với một máy chủ MCP hoặc viết một plugin đăng ký một công cụ tùy chỉnh qua ctx.register_tool().
Công cụ web_extract tích hợp sẵn của Hermes trả về Markdown nhưng áp dụng một cách cắt giảm ngân sách ký tự cứng và không được tài liệu hóa để render JavaScript; đường dẫn browser_navigate/browser_snapshot của nó có thể thêm xử lý proxy và chống bot, nhưng chỉ thông qua một backend cloud-browser kiểu Browserbase có trả phí và một vòng lặp tương tác cây truy cập nhiều bước.
Kết nối Nstproxy Crawl như một plugin Hermes mang lại cho agent một lệnh gọi công cụ duy nhất có thể render JavaScript, xác thực thông qua hồ bơi proxy của Nstproxy và trả về Markdown hoặc JSON sạch — mà không cần một đăng ký tự động hóa trình duyệt riêng biệt.
Việc tích hợp là một plugin Hermes dài ~40 dòng: một manifest plugin.yaml, một hàm register(ctx), và một bộ xử lý thực hiện POST đến endpoint /api/v1/crawl/scrape của Nstproxy Crawl và trả về Markdown đã được phân tích.
Nstproxy Crawl tính phí theo lượt fetch thành công (bao gồm cả phản hồi 404/403) thay vì theo lượt thử, và việc crawl cấp site cần có giới hạn maxDepth/maxPages rõ ràng — cả hai đều quan trọng khi một agent tự động gọi công cụ thay vì một người thực hiện từng yêu cầu một.

import json
import os
import requests

NSTPROXY_API_BASE = "https://api.nstproxy.com"


def register(ctx):
    schema = {
        "name": "nstproxy_crawl_scrape",
        "description": (
            "Lấy một URL và trả về Markdown sạch, hiển thị JavaScript và "
            "định tuyến qua nhóm proxy của Nstproxy. Sử dụng điều này cho các trang mà "
            "web_extract trả về ít nội dung, hoặc cần truy cập được hỗ trợ bởi proxy."
        ),
        "parameters": {
            "type": "object",
            "properties": {
                "url": {
                    "type": "string",
                    "description": "URL để lấy và chuyển đổi thành Markdown.",
                }
            },
            "required": ["url"],
        },
    }

    def handle_crawl_scrape(params, **kwargs):
        del kwargs
        target_url = (params or {}).get("url", "").strip()
        if not target_url:
            return json.dumps({"success": False, "error": "url là bắt buộc"})

        api_key = os.environ.get("NSTPROXY_API_KEY")
        if not api_key:
            return json.dumps({"success": False, "error": "NSTPROXY_API_KEY chưa được thiết lập"})

        response = requests.post(
            f"{NSTPROXY_API_BASE}/api/v1/crawl/scrape",
            headers={"x-api-key": api_key, "Content-Type": "application/json"},
            json={"url": target_url, "formats": ["markdown"], "onlyMainContent": True},
            timeout=60,
        )
        response.raise_for_status()
        envelope = response.json()

        if envelope.get("err"):
            return json.dumps({"success": False, "error": envelope.get("msg", "yêu cầu thất bại")})

        result = envelope.get("data", {})
        if not result.get("success"):
            return json.dumps({"success": False, "error": result.get("status", "crawl không hoàn thành")})

        page = result.get("data", {})
        return json.dumps({
            "success": True,
            "title": page.get("metadata", {}).get("title", ""),
            "markdown": page.get("markdown", ""),
        })

    ctx.register_tool(
        name="nstproxy_crawl_scrape",
        toolset="nstproxy_crawl",
        schema=schema,
        handler=handle_crawl_scrape,
    )

TL;DR

What Hermes Agent is

Why extend it with Nstproxy Crawl

Các yêu cầu tiên quyết

Cài đặt

Cấu hình

Bắt tay thực

Đính kèm công cụ

Ví dụ đã làm

Đầu ra trả về

Giới hạn

Kết luận

Câu hỏi thường gặp