Decodo

Decodo MCP Server

Kết nối LLM và tác nhân AI với dữ liệu web trực tiếp bằng MCP (Model Context Protocol). Decodo MCP Server cho phép bạn thu thập dữ liệu từ trang web, công cụ tìm kiếm, nền tảng thương mại điện tử và mạng xã hội trực tiếp từ các công cụ AI như Claude, Cursor và Windsurf mà không cần tự xây dựng cơ sở hạ tầng thu thập dữ liệu từ đầu.

• Đầu ra có cấu trúc ở định dạng JSON, Markdown và ảnh chụp màn hình
• Kết xuất JavaScript phía máy chủ và xử lý chống bot
• Hơn 125 triệu IP tại hơn 195 địa điểm

Decodo MCP server là gì?

Decodo MCP Server là một lớp thu thập dữ liệu web dành cho tác nhân AI. Server kết nối các ứng dụng khách tương thích với MCP với Decodo's Web Scraping API, cho phép:

• Thu thập dữ liệu web cho LLM
• Truy xuất dữ liệu theo thời gian thực cho RAG
• Tác nhân AI duyệt web và nghiên cứu
• Trích xuất dữ liệu có cấu trúc từ các trang web động

Thay vì duy trì proxy, trình phân tích cú pháp và logic thử lại, bạn chỉ cần một điểm tích hợp duy nhất để truy cập dữ liệu web đáng tin cậy.

Vì sao nên dùng MCP để thu thập dữ liệu web?

Model Context Protocol (MCP) là tiêu chuẩn mới nổi để kết nối tác nhân AI với các công cụ và nguồn dữ liệu bên ngoài. Với MCP:

• Tác nhân có thể gọi công cụ một cách linh hoạt
• Các tích hợp luôn tuân theo tiêu chuẩn
• Quy trình làm việc có thể mở rộng trên nhiều môi trường

Decodo MCP Server cung cấp cho tác nhân của bạn quyền truy cập web đáng tin cậy, sẵn sàng cho môi trường sản xuất thông qua tiêu chuẩn này.

Tính năng chính

Thu thập dữ liệu web cho tác nhân AI, không cần cơ sở hạ tầng. Thu thập dữ liệu từ mọi trang web, kể cả các trang sử dụng nhiều JavaScript, mà không cần xử lý xoay vòng proxy, giải CAPTCHA hoặc hệ thống chống bot.

Đầu ra có cấu trúc cho quy trình làm việc của LLM. Markdown (sẵn sàng cho LLM), JSON (dành cho quy trình có cấu trúc) và ảnh chụp màn hình (cung cấp ngữ cảnh trực quan), được thiết kế cho quy trình RAG, tác nhân nghiên cứu AI và luồng tự động hóa.

Tích hợp sẵn hỗ trợ các mục tiêu phổ biến. Công cụ có sẵn cho Google và Bing (SERP), Amazon, Walmart và Target (thương mại điện tử), TikTok và YouTube (mạng xã hội), cùng ChatGPT và Perplexity (tìm kiếm AI).

Cơ sở hạ tầng proxy toàn cầu. Hơn 115 triệu IP dân cư, hơn 195 vị trí địa lý và tỷ lệ thành công 99,99% ngay cả với những mục tiêu được bảo vệ nghiêm ngặt nhất.

Bộ công cụ MCP dạng mô-đun. Chỉ bật những gì bạn cần: web, search, ecommerce, social_media, ai để lựa chọn công cụ gọn gàng hơn và cải thiện hiệu suất của tác nhân.

Nhanh chóng đạt hiệu quả. Từ API key đến lần thu thập dữ liệu đầu tiên chỉ trong vài phút, không cần thiết lập phức tạp.

Trường hợp sử dụng

Sử dụng Decodo MCP Server khi bạn cần thu thập dữ liệu web cho tác nhân AI, trích xuất dữ liệu có cấu trúc ở quy mô lớn, truy cập đáng tin cậy vào các trang web động, dữ liệu theo thời gian thực cho RAG hoặc một giải pháp thay thế cho việc tự xây dựng cơ sở hạ tầng thu thập dữ liệu từ đầu. Các tình huống phổ biến:

• Thu thập dữ liệu web bằng AI – cho phép LLM thu thập dữ liệu mới thay vì dựa vào dữ liệu huấn luyện tĩnh.
• RAG với dữ liệu trực tiếp – đưa kết quả tìm kiếm Google, Bing và AI theo thời gian thực vào các quy trình truy xuất.
• Thông tin thương mại điện tử – theo dõi giá sản phẩm, danh sách mặt hàng và người bán trên các sàn giao dịch mà không bị chặn.
• Thu thập dữ liệu mạng xã hội – thu thập bài đăng, kênh và dữ liệu tương tác từ TikTok và YouTube.
• Tổng hợp giá và du lịch – xây dựng công cụ thu thập giá và tình trạng còn chỗ trực tiếp trên các trang web.

Bắt đầu nhanh

1. Tạo tài khoản miễn phí tại dashboard.decodo.com – tối đa 10K yêu cầu miễn phí, không cần thẻ tín dụng.
2. Lấy API key. Sao chép Web Data API key từ gói đăng ký Web Data API trên dashboard. Các gói cũ có token xác thực cơ bản, token này cũng hoạt động (xem Xác thực).
3. Tải Node.js 18+ từ https://nodejs.org.
4. Lấy MCP client như Claude Desktop, Cursor, Windsurf hoặc các công cụ tương thích MCP khác.
5. Cấu hình MCP server trong ứng dụng khách AI của bạn (xem các ví dụ cấu hình bên dưới).

Kết nối với MCP server của Decodo

Mở MCP client bạn muốn dùng và thêm cấu hình sau (xem ví dụ cho Claude Code, Cursor, Windsurf bên dưới):

{
  "mcpServers": {
    "Decodo": {
      "url": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Xác thực

Server cục bộ đọc một trong hai thông tin xác thực từ SCRAPER_API_TOKEN và tự xác định loại thông tin nhận được.

Claude Desktop

1. Mở Claude Desktop → Settings → Developer → Edit Config.
2. Thêm vào claude_desktop_config.json:

{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}

3. Lưu và khởi động lại Claude Desktop.

Cursor

1. Mở Settings → MCP.
2. Nhấp vào Add a new global MCP server (mở mcp.json).
3. Thêm cấu hình giống như trên.
4. Lưu — tìm chỉ báo trạng thái màu xanh lá bên cạnh Decodo.

Windsurf

1. Mở Settings → Windsurf Settings.
2. Cuộn đến Cascade → Add custom server + (mở mcp_config.json).
3. Thêm cấu hình giống như trên.
4. Lưu và khởi động lại Windsurf.

eve (Vercel)

1. Trong dự án tác nhân eve, chạy eve add connection/decodo, hoặc tạo agent/connections/decodo.ts:

import { always } from 'eve/tools/approval';
import { defineMcpClientConnection } from 'eve/connections';

export default defineMcpClientConnection({
  url: 'https://mcp.decodo.com/mcp',
  description:
    'Decodo: scrape web pages as Markdown, search the web, map and crawl sites, and read e-commerce and YouTube data.',
  headers: () => ({
    Authorization: `Bearer ${process.env.DECODO_API_KEY!}`,
  }),
  approval: always(),
});

2. Đặt DECODO_API_KEY=<api_key> trong môi trường phía máy chủ của tác nhân (.env.local cục bộ, biến môi trường dự án trên Vercel).
3. approval: always() sẽ hỏi trước mỗi lần gọi vì các lần gọi sử dụng gói của bạn; nếu muốn, hãy nới lỏng quy tắc này bằng các quy tắc phê duyệt của eve.

Kiểm tra thiết lập

Sau khi kết nối, hãy thử câu lệnh này trong ứng dụng khách của bạn:

▎ "Thu thập tiêu đề của 5 bài viết hàng đầu từ Hacker News"

Bạn sẽ nhận được danh sách có cấu trúc chỉ trong vài giây. Nếu gặp lỗi xác thực, hãy kiểm tra lại API key trên dashboard.

Phát triển cục bộ

Chỉ cần thực hiện nếu bạn muốn thay đổi mã server.

git clone https://github.com/Decodo/mcp-server

cd mcp-server
npm install
npm run build

cd build/
pwd

/Users/your.user/projects/mcp-server/build/index.js

{
  "mcpServers": {
    "decodo-mcp": {
      "command": "node",
      "args": ["/Users/your.user/projects/mcp-server/build/index.js"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>"
      }
    }
  }
}

Bộ công cụ

Các công cụ được sắp xếp thành các bộ công cụ. Bộ công cụ bạn nhận được tùy thuộc vào cách kết nối.

Claude (trình kết nối chính thức)

Trình kết nối Decodo trong thư mục trình kết nối của Claude chỉ bao gồm các công cụ Web Data API:

Mọi MCP client

Bạn có thể bật có chọn lọc các bộ công cụ cụ thể bằng cách truyền danh sách phân tách bằng dấu phẩy qua tham số truy vấn toolsets :

    "Decodo MCP Server": {
      "url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }

Khi không chỉ định bộ công cụ nào, tất cả công cụ sẽ được đăng ký.

Công cụ

Server cung cấp các công cụ sau:

Tham số

Các tham số sau được suy ra từ prompt của người dùng:

Ví dụ

Thu thập dữ liệu nội dung bị giới hạn theo khu vực địa lý

Gửi prompt sau cho tác nhân AI của bạn:

Scrape peacock.com from a German IP address and tell me the pricing.

Prompt này sẽ cho biết peacock.com bị giới hạn theo khu vực địa lý. Để vượt qua giới hạn địa lý:

Scrape peacock.com from a US IP address and tell me the pricing.

Giới hạn số lượng token phản hồi

Nếu tác nhân của bạn có cửa sổ ngữ cảnh nhỏ, nội dung trả về từ quá trình thu thập dữ liệu sẽ tự động bị cắt bớt để tránh tràn ngữ cảnh. Bạn có thể tăng số lượng token được trả về trong prompt của mình:

Scrape hacker news, return 50k tokens.

Nếu agent của bạn có cửa sổ ngữ cảnh lớn, hãy yêu cầu agent trả về full content:

Scrape hacker news, return full content.

Sử dụng với các kỹ năng agent của Decodo

Máy chủ này cung cấp cho agent của bạn các công cụ thu thập dữ liệu. Decodo/agent-skills hướng dẫn agent khi nào nên sử dụng chúng, nên dùng giao diện nào và cách gọi chúng — để agent tự chọn công cụ và tham số phù hợp thay vì đoán.

Các kỹ năng định tuyến giữa CLI decodo, máy chủ MCP được lưu trữ này và API HTTP thô, đồng thời tự động chuyển sang máy chủ MCP khi không có shell. Kết hợp cả hai giúp agent của bạn có cả lớp thực thi (máy chủ này) và lớp ra quyết định (các kỹ năng) trong cùng một thiết lập.

Bắt đầu nhanh (Claude Code):

/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills

Xem README về agent-skills để biết cách cài đặt thủ công và các agent khác (Cursor, Codex, Gemini CLI, Windsurf).

Các kho lưu trữ liên quan

Web Scraping API, kỹ năng agent của Decodo, kỹ năng Decodo OpenClaw

Dùng thử

Chỉ với vài cú nhấp chuột, hãy tích hợp Decodo MCP Server vào quy trình làm việc AI của bạn và trang bị cho các agent AI dữ liệu thời gian thực từ mọi trang web.

Bắt đầu miễn phí | Tài liệu | Discord

Giấy phép

Toàn bộ mã được phát hành theo Giấy phép MIT.