Kết nối Crawlens với Claude & các công cụ AI khác
Crawlens có sẵn MCP server. Sau khi kết nối, ứng dụng AI bạn đang dùng có thể đọc dữ liệu crawl và kết quả audit, rồi giải thích lỗi, sắp xếp thứ tự sửa và viết ticket. Nó dùng gói AI của chính bạn, nên không phải cài API key nào.
Ứng dụng Crawlens hiện chỉ có giao diện tiếng Anh, nên tên nút, menu và thông báo lỗi trong hướng dẫn này được giữ nguyên tiếng Anh để bạn dễ tìm.
MCP làm được gì
MCP (Model Context Protocol) là chuẩn để ứng dụng AI dùng công cụ bên ngoài. Khi ứng dụng AI cần dữ liệu từ Crawlens, nó khởi động MCP server của Crawlens ngay trên máy tính của bạn. Server đọc các lần crawl và kết quả audit đã lưu, rồi trả về kết quả gọn, có phân trang.
- Chỉ đọc. Nó không thể bắt đầu crawl, đổi thiết lập hay xóa bất cứ thứ gì.
- Chạy cục bộ. Nó chạy trên máy tính của bạn và không mở cổng mạng nào. Bản thân Crawlens không tải lên thứ gì.
- Không cần mở Crawlens. Ứng dụng AI tự khởi động server khi cần, dùng runtime có sẵn của Crawlens. Bạn không cần cài Node.js.
1. Bật tính năng trong Crawlens
Tính năng chia sẻ tắt theo mặc định. Công cụ AI không thấy gì cho đến khi bạn bật.
- Mở Crawlens và vào Settings → Integrations → AI tools (MCP).
- Bật Share audits with AI tools.
- Trong Projects AI tools can read, giữ All projects hoặc chọn Only these projects.
- Tùy chọn: bật Hide Search Console and Analytics data để ẩn click, lượt hiển thị, phiên truy cập và kết quả URL Inspection khỏi công cụ AI.
Bạn cần ít nhất một dự án có lần crawl đã được audit. Nếu chưa crawl gì, hãy làm việc đó trước. Trước đó, AI không có gì để đọc.
2. Kết nối công cụ AI
Cũng trong phần thiết lập đó có nút Copy setup for cho từng ứng dụng. Hãy dùng nút này: nó điền sẵn đúng đường dẫn trên máy bạn. Các đoạn mã dưới đây minh họa cấu hình đó, với đường dẫn mẫu.
Claude Desktop
- Bấm Add to Claude Desktop.
- Thoát hẳn rồi mở lại Claude Desktop. Đóng cửa sổ là chưa đủ: hãy thoát từ khay hệ thống (system tray).
- Trong một cuộc trò chuyện mới, mở menu tools. Bạn sẽ thấy
crawlenstrong danh sách.
Crawlens tự thêm vào claude_desktop_config.json và giữ nguyên các MCP server khác của bạn. Nếu file đã có sẵn, nó lưu một bản sao lưu kèm ngày tháng ngay bên cạnh trước khi sửa. Hỗ trợ cả bản Claude Desktop thông thường lẫn bản trên Microsoft Store.
Muốn tự sửa file cấu hình?
Thêm đoạn này vào %APPDATA%\Claude\claude_desktop_config.json, gộp với các mcpServers đã có:
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Claude Code
- Bấm Copy setup for → Claude Code.
- Dán lệnh vào terminal và chạy.
- Mở
claudevà chạy/mcpđể kiểm tracrawlensđã kết nối.
Lệnh này đăng ký Crawlens cho tài khoản người dùng của bạn (--scope user), nên dùng được trong mọi dự án:
claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"Codex
Một lần cài đặt dùng chung cho Codex CLI, extension trên IDE và ứng dụng Codex.
- Bấm Copy setup for → Codex.
- Dán vào cuối file
~/.codex/config.toml(tạo file nếu chưa có). - Khởi động lại Codex.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']
[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'Đoạn cấu hình đã sao chép có kèm lệnh codex mcp add … tương đương dưới dạng chú thích, nếu bạn muốn chạy lệnh đó.
Cursor
- Bấm Copy setup for → Cursor.
- Mở
~/.cursor/mcp.jsonvà dán vào. Nếu file đã có server khác, thêm mụccrawlensvào bên trongmcpServershiện có. - Kiểm tra Cursor Settings → MCP:
crawlensphải ở trạng thái bật.
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}VS Code
- Bấm Copy setup for → VS Code.
- Dán vào
.vscode/mcp.jsontrong workspace. Hoặc chạy MCP: Add Server từ Command Palette. - Mở Copilot Chat ở chế độ agent và kiểm tra
crawlenscó trong danh sách tools.
{
"servers": {
"crawlens": {
"type": "stdio",
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Ứng dụng MCP khác: mọi ứng dụng hỗ trợ MCP server dạng stdio đều dùng được. Dùng cùng lệnh, tham số và biến môi trường ELECTRON_RUN_AS_NODE=1 như trên.
3. Kiểm tra kết nối
Quay lại Crawlens, bấm Test connection. Crawlens khởi động server đúng như cách ứng dụng AI sẽ làm và báo lại kết quả, ví dụ:
Nếu bước này chạy được mà ứng dụng AI vẫn không thấy Crawlens, vấn đề nằm ở phía ứng dụng. Khởi động lại ứng dụng và xem phần Xử lý sự cố.
Nên hỏi gì
Gọi dự án bằng tên hoặc tên miền của nó. Bạn có thể hỏi bằng tiếng Việt. Vài câu hỏi hiệu quả:
Tóm tắt kết quả audit Crawlens mới nhất của example.com và đưa ra danh sách việc cần sửa theo thứ tự ưu tiên.
Viết title mới cho các trang đang thiếu title.
Giải thích các chuỗi redirect cho developer của chúng tôi.
Điều gì tệ đi so với lần crawl trước?
Trang nào có click từ Google nhưng trả về lỗi hoặc đang noindex?
Tìm các trang index được ở vị trí 11–20 và gợi ý cách đẩy chúng lên trang một.
Tool & prompt
Đây là những gì ứng dụng AI nhìn thấy. Kết quả được phân trang (mặc định 50 dòng) để website lớn không làm tràn cuộc trò chuyện.
| Tool | Trả về |
|---|---|
list_projects | Các dự án được chia sẻ từ Crawlens, kèm lần crawl mới nhất. |
list_crawls | Các lần crawl của một dự án, mới nhất trước, kèm điểm sức khỏe và số lỗi. |
get_overview | Tóm tắt một lần crawl đã audit: điểm sức khỏe, lỗi theo mức độ, lỗi hàng đầu, mã phản hồi, khả năng index, Core Web Vitals, và tổng số liệu Search Console, Analytics, log server khi có. |
list_issues | Mọi kiểm tra có lỗi: ý nghĩa, cách sửa và số URL bị ảnh hưởng (nghiêm trọng nhất trước). |
get_issue_urls | Các URL bị ảnh hưởng bởi một lỗi, kèm chi tiết của từng URL. |
query_urls | Lọc, sắp xếp và phân trang các URL đã crawl giống bảng URLs, gồm cả các cột Search Console, GA4 và custom extraction. |
get_url_details | Mọi thông tin về một URL: trường SEO, lỗi, link, redirect, header, structured data, HTML gốc so với HTML sau render, Core Web Vitals và dữ liệu tìm kiếm. |
compare_crawls | Thay đổi giữa hai lần crawl: điểm sức khỏe, lỗi mới và lỗi đã sửa theo từng kiểm tra, và thay đổi về URL. |
Các prompt có sẵn xuất hiện trong menu prompt hoặc lệnh slash của ứng dụng AI, nếu ứng dụng hỗ trợ:
| Prompt | Tác dụng |
|---|---|
| Summarise the audit & prioritise fixes | Tóm tắt điều hành kết quả audit mới nhất và kế hoạch sửa xếp theo tác động so với công sức, kèm người nên sửa từng mục và URL ví dụ. |
| Rewrite titles & meta descriptions | Title mới (30–60 ký tự) và description mới (70–160) cho các trang có lỗi title hoặc description, viết bằng chính ngôn ngữ của từng trang. |
| Explain an issue for developers | Giải thích một lỗi bằng URL và giá trị thật của website: nguyên nhân, cách kiểm tra, cách sửa và checklist. |
Quyền riêng tư & an toàn
- Tắt cho đến khi bạn bật, và bạn có thể tắt bất cứ lúc nào. Khi đó server từ chối mọi yêu cầu.
- Chỉ đọc. Server mở dữ liệu ở chế độ chỉ đọc. Nó không thể crawl, đổi thiết lập hay xóa bất cứ thứ gì.
- Không mở cổng mạng. Nó chỉ giao tiếp với ứng dụng AI qua standard input/output trên máy tính của bạn.
- Bạn chọn những gì được thấy: tất cả dự án hoặc chỉ một số, có hoặc không có dữ liệu Search Console và Analytics.
Crawlens không tải lên thứ gì, nhưng ứng dụng AI của bạn sẽ gửi những gì nó đọc tới dịch vụ AI của chính nó như một phần của cuộc trò chuyện. Việc đó tuân theo điều khoản quyền riêng tư của ứng dụng AI, nên hãy kiểm tra trước khi chia sẻ dữ liệu của khách hàng.
Xử lý sự cố
- Crawlens không xuất hiện trong ứng dụng AI
- Khởi động lại hẳn ứng dụng sau khi thêm cấu hình. Claude Desktop vẫn chạy ngầm ở khay hệ thống, nên hãy thoát từ đó. Với Cursor và VS Code, kiểm tra file JSON vẫn hợp lệ sau khi dán: thiếu một dấu phẩy là hỏng cả file.
- “Sharing audits with AI tools is turned off”
- Bật Share audits with AI tools trong Settings → Integrations → AI tools (MCP).
- “No shared project matches …”
- Dự án không nằm trong danh sách công cụ AI được đọc, hoặc tên không khớp. Thông báo lỗi liệt kê các dự án đang được chia sẻ. Thêm dự án vào Projects AI tools can read, hoặc hỏi bằng một trong các tên đó.
- “This project has no audited crawl yet”
- Hãy crawl website trong Crawlens trước. AI đọc kết quả audit, nên cần ít nhất một lần crawl đã xong và đã được audit.
- “This data was saved by an older Crawlens”
- Mở dự án trong Crawlens một lần. Việc đó cập nhật dữ liệu, và ứng dụng AI sẽ đọc được trở lại.
- Ngừng hoạt động sau khi chuyển chỗ hoặc cài lại Crawlens
- Cấu hình có chứa đường dẫn tới
Crawlens.exe. Sao chép lại cấu hình từ Crawlens (hoặc bấm lại Add to Claude Desktop) để đường dẫn được cập nhật. Chuyển thư mục dữ liệu trong Crawlens thì không sao: server tự đi theo. - “… is not valid JSON, so Crawlens left it untouched”
- File
claude_desktop_config.jsoncủa bạn đã có lỗi cú pháp từ trước, nên Crawlens không sửa nó. Sửa hoặc xóa file, rồi bấm lại Add to Claude Desktop.
Chưa có Crawlens?
Tải về, crawl một website, rồi quay lại đây để kết nối công cụ AI.