Máy chủ MCP chính thức của Apify dành cho các tác nhân AI để chạy Actors, trích xuất dữ liệu trang web, và tự động hóa các quy trình thu thập và quét dữ liệu web.
Tìm kiếm Apify Store — Yêu cầu trợ lý của bạn tìm các công cụ thu thập dữ liệu và tự động hóa bằng search-actors, sau đó xem chi tiết với fetch-actor-details.
Chạy bất kỳ Actor nào — Yêu cầu trợ lý thực thi một trình thu thập dữ liệu như call-actor hoặc apify--rag-web-browser được cấu hình sẵn để trích xuất dữ liệu từ trang web, mạng xã hội hoặc bản đồ.
Lấy kết quả chạy — Nhận các mục dữ liệu được phân trang bằng get-dataset-items hoặc kiểm tra trạng thái chạy và nhật ký qua get-actor-run và get-actor-log.
Quản lý lưu trữ — Truy cập dữ liệu từ bộ dữ liệu và kho lưu trữ khóa-giá trị bằng get-dataset, get-key-value-store-record và các công cụ danh sách liên quan.
Tạo và quản lý tác vụ — Lưu cấu hình Actor có thể tái sử dụng bằng create-actor-task, cập nhật chúng qua update-actor-task và xuất bản trang đích bằng publish-actor-task.
Tìm kiếm tài liệu Apify — Tra cứu tài liệu nền tảng bằng search-apify-docs và tải các trang đầy đủ qua fetch-apify-docs để có ngữ cảnh.
Máy chủ Model Context Protocol (MCP) của Apify tại mcp.apify.com cho phép các tác nhân AI của bạn trích xuất dữ liệu từ mạng xã hội, công cụ tìm kiếm, bản đồ, trang thương mại điện tử và bất kỳ trang web nào khác bằng hàng nghìn công cụ cào, thu thập và tự động hóa có sẵn từ Apify Store. Máy chủ hỗ trợ OAuth, cho phép bạn kết nối từ các ứng dụng khách như Claude.ai hoặc Visual Studio Code chỉ bằng URL.
🚀 Sử dụng Apify MCP Server được lưu trữ!
Để có trải nghiệm tốt nhất, hãy kết nối trợ lý AI của bạn với máy chủ được lưu trữ của chúng tôi tại https://mcp.apify.com. Máy chủ được lưu trữ hỗ trợ các tính năng mới nhất - bao gồm cả suy luận lược đồ đầu ra cho kết quả Actor có cấu trúc - những tính năng không khả dụng khi chạy cục bộ qua stdio.
⚠️ Đã loại bỏ giao thức SSE kế thừa. Điểm cuối https://mcp.apify.com/sse đã bị loại bỏ để chuyển sang Streamable HTTP. Hãy di chuyển ứng dụng khách của bạn đến https://mcp.apify.com — bỏ hậu tố /sse khỏi cấu hình của bạn.
💰 Máy chủ cũng hỗ trợ thanh toán đại lý: mua token từ AGI để chạy bất kỳ Actor nào, hoặc thanh toán theo yêu cầu qua x402 trực tiếp (chỉ dành cho Actor Pay Per Event) hoặc Skyfire.
Apify MCP Server tương thích với Claude Code, Claude.ai, Cursor, VS Code và bất kỳ ứng dụng khách nào tuân thủ Model Context Protocol.
Xem phần MCP clients để biết thêm chi tiết hoặc truy cập trang cấu hình MCP.
Sử dụng Instagram Scraper để cào bài đăng, hồ sơ, địa điểm, ảnh và bình luận trên Instagram.
Sử dụng RAG Web Browser để tìm kiếm trên web, cào N URL hàng đầu và trả về nội dung của chúng.
Sử dụng Web Fetch để tìm nạp bất kỳ URL nào và trả về nội dung của nó dưới dạng Markdown, văn bản thuần túy, HTML hoặc liên kết — với khả năng kết xuất JavaScript và bảo vệ chống bot.
Video hướng dẫn: Tích hợp hơn 8.000 Apify Actor và Agent với Claude
🚀 Bắt đầu nhanh
Bạn có thể sử dụng Apify MCP Server theo hai cách:
Điểm cuối HTTPS (mcp.apify.com): Kết nối từ ứng dụng khách MCP của bạn qua OAuth hoặc bằng cách bao gồm tiêu đề Authorization: Bearer <APIFY_TOKEN> trong các yêu cầu của bạn. Đây là phương pháp được khuyến nghị cho hầu hết các trường hợp sử dụng. Vì nó hỗ trợ OAuth, bạn có thể kết nối từ các ứng dụng khách như Claude.ai hoặc Visual Studio Code chỉ bằng URL: https://mcp.apify.com.
https://mcp.apify.com streamable transport
Đầu vào/Đầu ra chuẩn (stdio): Lý tưởng cho các tích hợp cục bộ và các công cụ dòng lệnh như ứng dụng khách Claude for Desktop.
Đặt lệnh máy chủ của ứng dụng khách MCP thành npx @apify/actors-mcp-server và biến môi trường APIFY_TOKEN thành token API Apify của bạn.
Xem npx @apify/actors-mcp-server --help để biết thêm các tùy chọn.
Bạn có thể tìm thấy hướng dẫn chi tiết để thiết lập máy chủ MCP trong tài liệu Apify.
🤖 Ứng dụng khách MCP
Apify MCP Server tương thích với bất kỳ ứng dụng khách MCP nào tuân thủ Model Context Protocol, nhưng mức độ hỗ trợ cho việc khám phá công cụ động và các tính năng khác có thể khác nhau giữa các ứng dụng khách.
Giao diện tương tác kiểu trò chuyện này cung cấp một cách dễ dàng để khám phá các khả năng của Apify MCP mà không cần thiết lập cục bộ.
Đăng nhập bằng tài khoản Apify của bạn và bắt đầu thử nghiệm với các công cụ cào web, trích xuất dữ liệu và tự động hóa!
Hoặc sử dụng tệp gói MCP (trước đây gọi là tệp tiện ích mở rộng Anthropic Desktop, hoặc DXT) để cài đặt một cú nhấp chuột: Tệp MCPB Apify MCP Server
💰 Thanh toán đại lý
Bạn có thể thanh toán cho các lần chạy Actor mà không cần token API Apify bằng cách sử dụng AGI, x402 trực tiếp hoặc Skyfire.
AGI (agi.apify.com) tạo ra một token API Apify trả trước để đổi lấy thanh toán x402 hoặc MPP. Sử dụng token như một token API thông thường đối với mcp.apify.com và api.apify.com — hoạt động cho bất kỳ Actor nào, không chỉ các Actor Pay Per Event. Được khuyến nghị cho các tích hợp mới; xem AGI (được khuyến nghị) bên dưới.
x402 trực tiếp thanh toán bằng USDC trên Base theo từng yêu cầu và không yêu cầu tài khoản nền tảng riêng. Nó được hỗ trợ đầy đủ bởi mcpc (brew install apify/tap/mcpc hoặc npm install -g @apify/mcpc). Chúng tôi sử dụng mcpc vì nó là một trong số ít ứng dụng khách MCP hỗ trợ các tính năng mới nhất và giao thức x402 một cách tự nhiên.
Skyfire thanh toán bằng token PAY và yêu cầu tài khoản Skyfire có ví đã được nạp tiền. Nó không yêu cầu ứng dụng khách MCP đặc biệt; toàn bộ quy trình thanh toán được xử lý trực tiếp thông qua các tham số gọi công cụ MCP.
ℹ️ Phạm vi: Cả x402 trực tiếp và Skyfire đều bị giới hạn ở các Actor Pay Per Event, không hỗ trợ Actor Standby và thanh toán theo từng lần chạy thay vì tạo token.
Cách thanh toán đại lý hoạt động
Chi phí chạy Actor khác nhau, vì vậy cả hai phương thức thanh toán đều sử dụng mô hình số dư trả trước. Quy trình thanh toán diễn ra theo bốn bước:
Khám phá: Tác nhân khám phá các Actor bằng search-actors hoặc fetch-actor-details. Các cuộc gọi đó miễn phí.
Thanh toán trước: Trước khi chạy một công cụ Actor trả phí, tác nhân sẽ nạp số dư trả trước.
x402 trực tiếp: mcpc tự động ký giao dịch USDC trị giá $1,00.
Skyfire: Tác nhân tạo một token PAY (tối thiểu $5,00) bằng công cụ create-pay-token của Skyfire.
Thực thi: Tác nhân gọi công cụ Actor.
x402 trực tiếp: Được xử lý tự động bởi mcpc bằng số dư trả trước.
Skyfire: Tác nhân chuyển token PAY một cách tường minh trong thuộc tính đầu vào skyfire-pay-id.
Hoàn tất: Công cụ trả về kết quả Actor. Số tiền chưa sử dụng vẫn khả dụng cho các lần chạy sau.
x402 trực tiếp: Sau 60 phút không hoạt động, máy chủ hoàn lại số dư chưa sử dụng cho ví trên Base.
Skyfire: Skyfire trả lại số tiền chưa sử dụng khi token hết hạn.
🪙 AGI (được khuyến nghị)
AGI (Apify Agent General Interface) là cách được khuyến nghị để các tác nhân tự động thanh toán cho việc sử dụng Apify mà không cần tài khoản. Thanh toán một lần qua x402 hoặc MPP, nhận một token API Apify trả trước, có giới hạn chi tiêu và sử dụng trực tiếp đối với mcp.apify.com và api.apify.com (Authorization: Bearer <token>) — cho bất kỳ Actor nào.
Giao thức đầy đủ, các phương thức thanh toán được hỗ trợ và các điều khoản hiện tại (số tiền tối thiểu, thời hạn token, chính sách hoàn tiền) được ghi lại tại agi.apify.com/AGENTS.md — hãy coi đó là nguồn thông tin duy nhất.
💸 x402 trực tiếp
Giao thức x402 cho phép thanh toán trực tiếp giữa máy với máy. Ứng dụng khách MCP của bạn có thể sử dụng nó để thanh toán cho các lần chạy Actor bằng USDC trên blockchain Base, hoàn toàn bỏ qua nhu cầu về token API Apify.
# Create a new wallet
mcpc x402 init
# Import an existing wallet
mcpc x402 import <private-key>
# Show the wallet address and a funding QR code, so you can fund it with USDC on Base (https://base.org)
mcpc x402
mcpc @apify tools-call call-actor actor:="apify/rag-web-browser" input:='{"query": "latest AI news"}'
🔥 Skyfire
Skyfire cung cấp cơ sở hạ tầng thanh toán được quản lý cho các tác nhân AI. Thay vì xác thực bằng token API Apify, tác nhân của bạn chuyển một token thanh toán Skyfire để trang trải chi phí cho mỗi lần gọi công cụ bằng token PAY.
Máy chủ MCP cung cấp một bộ công cụ để tương tác với các Apify Actor.
Vì Apify Store lớn và đang phát triển nhanh chóng, máy chủ MCP cung cấp một cách để khám phá và sử dụng các Actor mới một cách động.
Actor
Bất kỳ Apify Actor nào cũng có thể được sử dụng như một công cụ.
Theo mặc định, máy chủ được cấu hình sẵn với hai Actor, apify/rag-web-browser và apify/web-fetch, cùng một số công cụ trợ giúp.
Máy chủ MCP tải lược đồ đầu vào của một Actor và tạo một công cụ MCP tương ứng.
Điều này cho phép tác nhân AI biết chính xác những đối số nào cần chuyển cho Actor và những gì sẽ nhận được khi trả về.
Ví dụ: đối với Actor apify/rag-web-browser, các tham số đầu vào là:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}
Bạn không cần chỉ định thủ công Actor nào cần gọi hoặc các tham số đầu vào của nó; LLM xử lý việc này tự động.
Khi một công cụ được gọi, các đối số sẽ tự động được chuyển cho Actor bởi LLM.
Bạn có thể tham khảo tài liệu của từng Actor cụ thể để biết danh sách các đối số khả dụng.
Công cụ trợ giúp
Một trong những tính năng mạnh mẽ nhất khi sử dụng MCP với Apify là khám phá công cụ động.
Nó cho phép tác nhân AI tìm các công cụ (Actor) mới khi cần và kết hợp chúng.
Dưới đây là một số thao tác MCP đặc biệt và cách Apify MCP Server hỗ trợ chúng:
Apify Actors: Tìm kiếm Actor, xem chi tiết của chúng và sử dụng chúng làm công cụ cho AI.
Tài liệu Apify: Tìm kiếm tài liệu Apify và tìm nạp các tài liệu cụ thể để cung cấp ngữ cảnh cho AI.
Lần chạy Actor: Lấy danh sách các lần chạy Actor của bạn, kiểm tra chi tiết của chúng và truy xuất nhật ký.
Bộ lưu trữ Apify: Truy cập dữ liệu từ các tập dữ liệu và kho lưu trữ khóa-giá trị của bạn.
Tác vụ Actor: Tạo, kiểm tra và cập nhật các tác vụ Actor đã lưu của bạn, đồng thời xuất bản hoặc hủy xuất bản các trang đích công khai của chúng.
Tổng quan về các công cụ khả dụng
Dưới đây là danh sách tổng quan về tất cả các công cụ được cung cấp bởi Apify MCP Server.
Chú giải cho cột Được bật theo mặc định:
✅ — nằm trong bộ công cụ mặc định.
⚡ — được tự động chèn khi có call-actor, một công cụ Actor, hoặc get-actor-run (điều này đúng trong cấu hình mặc định).
✅¹ — được phục vụ theo mặc định, nhưng chỉ khi telemetry được bật và máy khách không bị giữ lại: Anthropic hiển thị (Claude.ai / Claude Desktop / Claude Code) hoặc local-agent-mode-apify. Để tắt, hãy truyền danh sách tools= tường minh bỏ qua nó.
Tên công cụ
Danh mục
Mô tả
Được bật theo mặc định
search-actors
actors
Tìm kiếm Actor trong Apify Store.
✅
fetch-actor-details
actors
Truy xuất thông tin chi tiết về một Actor cụ thể, bao gồm lược đồ đầu vào, README (tóm tắt khi có sẵn, đầy đủ nếu không), giá cả và lược đồ đầu ra của Actor.
✅
call-actor
actors
Gọi một Actor và nhận kết quả chạy của nó. Sử dụng fetch-actor-details trước để lấy lược đồ đầu vào của Actor.
✅
get-actor-run
runs
Lấy thông tin chi tiết về một lần chạy Actor cụ thể.
⚡
get-dataset-items
storage
Truy xuất các mục từ một dataset với hỗ trợ lọc và phân trang.
⚡
get-key-value-store-record
storage
Lấy giá trị liên kết với một khóa cụ thể trong key-value store.
⚡
abort-actor-run
runs
Hủy bỏ một lần chạy Actor đang chạy, tùy chọn một cách nhẹ nhàng.
⚡
search-apify-docs
docs
Tìm kiếm tài liệu Apify cho các trang có liên quan.
✅
fetch-apify-docs
docs
Tìm nạp toàn bộ nội dung của một trang tài liệu Apify theo URL của nó.
Một công cụ Actor để tìm nạp một URL và trả về nội dung của nó.
✅
report-problem
dev
Báo cáo sự cố với một công cụ hoặc Actor Apify cho nhóm Apify.
✅¹
get-actor-run-list
runs
Lấy danh sách các lần chạy của một Actor, có thể lọc theo trạng thái.
get-actor-log
runs
Truy xuất nhật ký cho một lần chạy Actor cụ thể.
get-dataset
storage
Lấy siêu dữ liệu về một dataset cụ thể.
get-dataset-schema
storage
Tạo lược đồ JSON từ các mục dataset.
get-key-value-store
storage
Lấy siêu dữ liệu về một key-value store cụ thể.
get-key-value-store-keys
storage
Liệt kê các khóa trong một key-value store cụ thể.
get-dataset-list
storage
Liệt kê tất cả các dataset có sẵn cho người dùng.
get-key-value-store-list
storage
Liệt kê tất cả các key-value store có sẵn cho người dùng.
create-actor-task
tasks
Tạo một tác vụ Actor đã lưu (một cấu hình Actor có tên, có thể tái sử dụng).
get-actor-task
tasks
Lấy một tác vụ Actor đã lưu, trạng thái xuất bản và cấu hình hiển thị công khai của nó.
update-actor-task
tasks
Cập nhật đầu vào của tác vụ, tùy chọn chạy hoặc cấu hình hiển thị công khai.
publish-actor-task
tasks
Xuất bản một tác vụ trên trang đích công khai của nó.
unpublish-actor-task
tasks
Hủy xuất bản một tác vụ khỏi trang đích công khai của nó.
Lưu ý:
Khi có call-actor, một công cụ Actor, hoặc get-actor-run, máy chủ tự động chèn get-actor-run, get-dataset-items, get-key-value-store-record và abort-actor-run.
Khi bạn gọi một Actor — thông qua call-actor hoặc trực tiếp qua một công cụ Actor (ví dụ: apify--rag-web-browser) — phản hồi chứa siêu dữ liệu chạy, ID lưu trữ và summary + nextStep, nhưng không có mục dataset. Để tìm nạp các mục, hãy làm theo nextStep và gọi get-dataset-items (tự động chèn), truyền datasetId được trả về từ lệnh gọi.
Chú thích công cụ
Tất cả các công cụ bao gồm chú thích siêu dữ liệu để giúp máy khách MCP và LLM hiểu hành vi của công cụ:
title: Tên hiển thị ngắn cho công cụ (ví dụ: "Search Actors", "Call Actor", "apify/rag-web-browser")
readOnlyHint: true cho các công cụ chỉ đọc dữ liệu mà không sửa đổi trạng thái (ví dụ: get-dataset, fetch-actor-details)
openWorldHint: true cho các công cụ truy cập tài nguyên bên ngoài ngoài nền tảng Apify (ví dụ: call-actor thực thi các Actor bên ngoài). Các công cụ chỉ tương tác với nền tảng Apify (như search-actors hoặc fetch-apify-docs) không có gợi ý này.
Cấu hình công cụ
Tham số cấu hình tools được sử dụng để chỉ định các công cụ được tải – hoặc các danh mục hoặc các công cụ cụ thể trực tiếp, và các Actor Apify. Ví dụ: tools=storage,runs tải hai danh mục; tools=call-actor chỉ tải một công cụ.
Khi không có tham số truy vấn nào được cung cấp, máy chủ MCP tải các tools sau theo mặc định:
actors
docs
apify/rag-web-browser
apify/web-fetch
Nếu tham số công cụ được chỉ định, chỉ các công cụ hoặc danh mục được liệt kê sẽ được bật – không có công cụ mặc định nào được bao gồm.
report-problem được phục vụ theo mặc định (tùy thuộc vào kiểm soát trong chú thích cuối trang ở trên) nhưng nằm trong danh mục dev, vì vậy một tools=dev tường minh cũng chọn nó. Để tắt, hãy truyền danh sách tools= tường minh bỏ qua nó (ví dụ: tools=actors,docs).
Cấu hình dễ dàng:
Sử dụng trình cấu hình UI để cấu hình máy chủ của bạn, sau đó sao chép cấu hình vào máy khách của bạn.
Cấu hình máy chủ được lưu trữ:
Máy chủ được lưu trữ có thể được cấu hình bằng các tham số truy vấn trong URL. Ví dụ: để tải các công cụ mặc định, sử dụng:
Đối với cấu hình tối thiểu, nếu bạn muốn chỉ sử dụng một công cụ Actor duy nhất - không có bất kỳ công cụ khám phá hoặc gọi chung nào, máy chủ có thể được cấu hình như sau:
https://mcp.apify.com?tools=apify/my-actor
Thiết lập này chỉ hiển thị Actor được chỉ định (apify/my-actor) như một công cụ. Không có công cụ nào khác sẽ có sẵn.
Cấu hình CLI:
CLI có thể được cấu hình bằng các cờ dòng lệnh. Ví dụ: để tải các công cụ giống như trong cấu hình máy chủ được lưu trữ, sử dụng:
Như trên, điều này chỉ hiển thị Actor được chỉ định (apify/my-actor) như một công cụ. Không có công cụ nào khác sẽ có sẵn.
⚠️ Khuyến nghị quan trọng
Cấu hình công cụ mặc định có thể thay đổi trong các phiên bản tương lai. Khi không có tham số tools nào được chỉ định, máy chủ hiện tải các công cụ mặc định, nhưng hành vi này có thể thay đổi.
Đối với sử dụng sản xuất và giao diện ổn định, luôn chỉ định rõ ràng tham số tools để đảm bảo cấu hình của bạn nhất quán qua các bản cập nhật.
Cấu hình chế độ UI
Tham số ui bật kết xuất tiện ích MCP Apps trong phản hồi công cụ. Khi được bật, các công cụ như search-actors trả về phản hồi MCP App tương tác.
Cấu hình máy chủ được lưu trữ:
Bật chế độ UI bằng tham số truy vấn ui:
https://mcp.apify.com?ui=true
Bạn có thể kết hợp nó với các tham số khác:
https://mcp.apify.com?tools=actors,docs&ui=true
Cấu hình CLI:
CLI có thể được cấu hình bằng các cờ dòng lệnh. Ví dụ: để bật chế độ UI:
npx @apify/actors-mcp-server --ui true
Bạn cũng có thể đặt nó qua biến môi trường UI_MODE:
export UI_MODE=true
npx @apify/actors-mcp-server
Khả năng tương thích ngược
Cấu hình v2 bảo tồn khả năng tương thích ngược với cách sử dụng v1. Lưu ý:
Tham số actors (URL) và cờ --actors (CLI) vẫn được hỗ trợ.
Bên trong, chúng được hợp nhất vào các bộ chọn tools.
enableAddingActors (URL), enable-adding-actors (CLI) và bí danh enableActorAutoLoading kế thừa đã bị xóa. Để gọi Actor động, sử dụng tools=call-actor (được bao gồm theo mặc định qua danh mục actors). Bất kỳ giá trị thô còn sót lại nào đều bị bỏ qua.
Các mặc định vẫn tương thích: khi không có tools nào được chỉ định, máy chủ tải actors, docs, apify/rag-web-browser và apify/web-fetch.
Nếu bất kỳ tools nào được chỉ định, các mặc định không được thêm vào (giống như ý định v1 cho lựa chọn tường minh).
call-actor hiện được bao gồm theo mặc định qua danh mục actors (thay đổi bổ sung). Để loại trừ nó, chỉ định danh sách tools tường minh không có actors.
tools=add-actor, tools=experimental và tools=preview đã ngừng hoạt động: chúng bị bỏ qua và không tải công cụ nào. Sử dụng tools=call-actor (hoặc danh mục actors mặc định) thay thế.
Các URL và lệnh hiện có sử dụng ?actors=... hoặc --actors tiếp tục hoạt động không thay đổi.
Lời nhắc
Máy chủ quảng cáo khả năng prompts, nhưng hiện không có lời nhắc nào được đăng ký — prompts/list trả về danh sách trống.
Tài nguyên
Dữ liệu Apify của bạn không được liệt kê trong resources/list — các lần đọc theo yêu cầu: truyền bất kỳ URL GET API Apify nào (https://api.apify.com/v2/...) cho resources/read và máy chủ chèn mã thông báo Apify của phiên và trả về nội dung phản hồi. resources/templates/list liệt kê các hình dạng phổ biến — các mục dataset, bản ghi và khóa key-value store, siêu dữ liệu chạy, nhật ký chạy — với các tham số phân trang của chúng. Phản hồi nội tuyến lên đến 256 KB; bất cứ thứ gì lớn hơn trả về thông báo ngắn với URL tải xuống thay vì nội dung. Các lần đọc API yêu cầu mã thông báo Apify, vì vậy phiên chỉ-thanh-toán (x402 hoặc Skyfire) sẽ nhận được lỗi JSON-RPC cho chúng.
💬 Ví dụ sử dụng
Dưới đây là các ví dụ thực tế cho thấy cách một trợ lý AI sử dụng các công cụ Apify MCP Server.
Ví dụ 1: Tìm kiếm web bằng RAG Web Browser
Lời nhắc của người dùng:
Tìm tin tức mới nhất về các tác nhân AI tự trị và tóm tắt các phát triển chính.
Trợ lý AI gọi công cụ Actor apify--rag-web-browser được cấu hình sẵn để tìm kiếm web và trả về nội dung từ các kết quả hàng đầu.
Công cụ trả về nội dung markdown từ 3 kết quả tìm kiếm hàng đầu, sau đó trợ lý AI tóm tắt cho người dùng.
Ví dụ 2: Khám phá và chạy một Actor từ Apify Store
Lời nhắc của người dùng:
Thu thập 10 nhà hàng hàng đầu ở Praha từ Google Maps với thông tin liên hệ của họ.
Trợ lý AI trước tiên tìm kiếm một Actor phù hợp, kiểm tra lược đồ đầu vào của nó, sau đó thực thi nó.
Công cụ trả về bản xem trước của dữ liệu được thu thập bao gồm tên nhà hàng, địa chỉ, xếp hạng, số điện thoại và trang web.
Ví dụ 3: Truy xuất và phân trang qua kết quả chạy Actor
Lời nhắc của người dùng:
Hiển thị cho tôi 10 kết quả tiếp theo từ lần chạy thu thập đó.
Trợ lý AI sử dụng ID dataset từ lần chạy Actor trước đó để tìm nạp các mục bổ sung.
Đầu ra dự kiến: Công cụ trả về trang tiếp theo của các mục dữ liệu có cấu trúc từ dataset đầu ra của Actor.
📡 Telemetry
Apify MCP Server thu thập dữ liệu telemetry về các lệnh gọi công cụ để giúp Apify hiểu các mẫu sử dụng và cải thiện dịch vụ.
Theo mặc định, telemetry được bật cho tất cả các lệnh gọi công cụ.
Phương thức vận chuyển stdio cũng sử dụng Sentry để theo dõi lỗi, giúp chúng tôi xác định và khắc phục sự cố nhanh hơn.
Sentry tự động bị tắt khi telemetry bị từ chối.
Từ chối telemetry
Bạn có thể từ chối telemetry (bao gồm cả theo dõi lỗi Sentry) bằng cách đặt cờ CLI --telemetry-enabled thành false hoặc biến môi trường TELEMETRY_ENABLED thành false.
Các cờ CLI có quyền ưu tiên hơn các biến môi trường.
Ví dụ
Đối với máy chủ từ xa (mcp.apify.com):
# Disable via URL parameter
https://mcp.apify.com?telemetry-enabled=false
Đối với máy chủ stdio cục bộ:
# Disable via CLI flag
npx @apify/actors-mcp-server --telemetry-enabled=false
# Or set environment variable
export TELEMETRY_ENABLED=false
npx @apify/actors-mcp-server
⚙️ Phát triển
Vui lòng xem hướng dẫn CONTRIBUTING.md để biết các nguyên tắc đóng góp và quy ước thông điệp cam kết.
Để biết thiết lập phát triển chi tiết, cấu trúc dự án và hướng dẫn kiểm thử cục bộ, xem hướng dẫn DEVELOPMENT.md.
Khi khởi chạy, Inspector sẽ hiển thị một URL mà bạn có thể mở trong trình duyệt để bắt đầu gỡ lỗi.
Truy cập không cần xác thực
Khi tham số truy vấn tools chỉ bao gồm các công cụ được bật rõ ràng cho mục đích sử dụng không cần xác thực, máy chủ được lưu trữ cho phép truy cập mà không cần mã thông báo API.
Các công cụ hiện được phép: search-actors, fetch-actor-details, search-apify-docs, fetch-apify-docs.
Ví dụ: https://mcp.apify.com?tools=search-actors.
🐦 Bản phát hành canary PR
Apify MCP được chia thành hai kho lưu trữ: kho lưu trữ này dành cho logic MCP cốt lõi và apify-mcp-server-internal riêng tư dành cho máy chủ được lưu trữ.
Các thay đổi phải được đồng bộ hóa giữa cả hai.
Để tạo bản phát hành canary, hãy thêm nhãn beta vào yêu cầu kéo của bạn.
Thao tác này sẽ xuất bản gói lên pkg.pr.new để dàn dựng và thử nghiệm trước khi hợp nhất.
Xem tệp quy trình làm việc để biết chi tiết.
🐋 Tích hợp Docker Hub
Máy chủ Apify MCP cũng có sẵn trên Docker Hub, được đăng ký thông qua kho lưu trữ mcp-registry. Mục nhập trong servers/apify-mcp-server/server.yaml sẽ được triển khai tự động bởi sổ đăng ký MCP của Docker Hub (tần suất triển khai không xác định). Trước khi thực hiện các thay đổi lớn đối với phiên bản máy chủ stdio, hãy kiểm tra cục bộ để đảm bảo bản dựng Docker vượt qua. Để kiểm tra, hãy thay đổi source.branch thành nhánh PR của bạn và chạy task build -- apify-mcp-server. Để biết thêm chi tiết, hãy xem CONTRIBUTING.md.
Lược đồ đầu vào của Actor được xử lý để tương thích với hầu hết các máy khách MCP đồng thời tuân thủ các tiêu chuẩn JSON Schema. Quá trình xử lý bao gồm:
Mô tả được cắt ngắn xuống còn 500 ký tự (như được định nghĩa trong MAX_DESCRIPTION_LENGTH).
Trường enum được cắt ngắn xuống tổng chiều dài tối đa 2000 ký tự cho tất cả các phần tử (như được định nghĩa trong ACTOR_ENUM_MAX_LENGTH).
Trường bắt buộc được đánh dấu rõ ràng bằng tiền tố REQUIRED trong mô tả của chúng để tương thích với các framework có thể không xử lý đúng lược đồ JSON.
Thuộc tính lồng nhau được xây dựng cho các trường hợp đặc biệt như cấu hình proxy và nguồn danh sách yêu cầu để đảm bảo cấu trúc đầu vào chính xác.
Loại phần tử mảng được suy ra khi không được xác định rõ ràng trong lược đồ, sử dụng thứ tự ưu tiên: loại rõ ràng trong items > loại prefill > loại giá trị mặc định > loại trình chỉnh sửa.
Giá trị enum và ví dụ được thêm vào mô tả thuộc tính để đảm bảo hiển thị, ngay cả khi máy khách không hỗ trợ đầy đủ lược đồ JSON.
Actor cho thuê chỉ khả dụng khi sử dụng với máy chủ MCP được lưu trữ tại https://mcp.apify.com. Khi chạy máy chủ cục bộ qua stdio, bạn chỉ có thể truy cập các Actor đã được thêm vào bộ công cụ cục bộ của mình. Để tìm kiếm và sử dụng động bất kỳ Actor nào từ Apify Store—bao gồm cả Actor cho thuê—hãy kết nối với điểm cuối được lưu trữ.
🔒 Chính sách quyền riêng tư
Khi bạn sử dụng máy chủ này, các yêu cầu và đầu vào Actor của bạn sẽ được gửi đến API Apify để thực thi.
Dữ liệu không được chia sẻ với bên thứ ba ngoài những gì cần thiết để chạy các Actor được yêu cầu.
Để biết chi tiết đầy đủ về thu thập, sử dụng, chia sẻ và lưu giữ dữ liệu, hãy xem Apify Legal.
🤝 Đóng góp
Chúng tôi hoan nghênh các báo cáo lỗi, yêu cầu tính năng và sửa lỗi tài liệu. Hãy gửi cho chúng tôi vấn đề, không phải bản vá — một vấn đề chính xác kèm bản tái hiện hữu ích hơn một yêu cầu kéo.
🐛 Báo cáo lỗi: Mở một issue kèm bản tái hiện. Điều hữu ích nhất bạn có thể gửi cho chúng tôi.
💡 Đề xuất tính năng: Mở một issue — vấn đề và ai gặp phải, không phải cách triển khai.
🔧 Mã nguồn: Chỉ làm việc trên các issue được người bảo trì mời. Một issue đang mở không phải là lời mời để bạn nhận; các yêu cầu kéo không được yêu cầu sẽ bị đóng.
📚 Tài liệu: Lỗi chính tả, liên kết hỏng và lệnh sai sẽ được chuyển trực tiếp thành PR.
