AIHawk

1. AIHawk là gì?

Trước hết là một thông báo quan trọng: địa chỉ github.com/feder-cr/aihawk hiện tự chuyển hướng sang github.com/feder-cr/invisible_playwright_mcp. Tác giả đã đổi tên và đổi hẳn nội dung repo. AIHawk ngày trước là công cụ tự động nộp đơn xin việc. Còn thứ đang nằm ở địa chỉ này hôm nay là invisible_playwright_mcp: một "trợ lý lướt web" chạy bằng AI. README hiện tại không còn hướng dẫn cài công cụ nộp đơn cũ, nên bài này hướng dẫn đúng thứ bạn sẽ nhận được khi mở repo.

invisible_playwright_mcp làm việc như sau: bạn gõ yêu cầu bằng lời thường, ví dụ "vào trang này, xem giá vé từng ngày rồi báo lại". Nó mở một trình duyệt Firefox thật trên máy bạn, tự bấm, tự gõ, tự đọc trang và trả kết quả. Trình duyệt này được chỉnh để trang web nhìn nó như một Firefox bình thường, nên ít bị chặn nhầm là robot hơn các công cụ tự động khác.

Phần mềm miễn phí, mã nguồn mở (giấy phép MIT). Nhưng bộ não AI thì không miễn phí: bạn phải tự mang khóa của dịch vụ mô hình AI và trả tiền theo lượng dùng.

Hợp với bạn nếu:

• Bạn dùng Windows hoặc Linux và chịu gõ vài lệnh.
• Bạn có những việc lặp lại trên web: dò giá, gom thông tin từ nhiều trang, điền biểu mẫu.
• Bạn đã dùng Claude Code, Codex hoặc Gemini CLI và muốn cho trợ lý của mình một trình duyệt.

Chưa hợp nếu:

• Bạn dùng máy Mac hoặc điện thoại. Lõi trình duyệt của dự án chỉ có bản cho Windows và Linux.
• Bạn đang tìm lại công cụ nộp đơn xin việc AIHawk cũ. Nó không còn được hướng dẫn ở đây.
• Bạn muốn một công cụ giải captcha. Tài liệu ghi rõ: đây là trình duyệt, không phải công cụ giải hay vượt captcha.
• Bạn không muốn trả tiền cho mô hình AI.

2. Cần chuẩn bị gì?

Máy tính: Windows 64-bit hoặc Linux. Lần chạy đầu, phần mềm tự tải lõi trình duyệt từ GitHub: khoảng 240 MB trên Windows, giải nén ra khoảng 550 MB. Bạn cần mạng ổn định và còn trống ít nhất chừng đó ổ cứng.

Phần mềm cài trước:

• uv: công cụ cài và chạy chương trình Python. Nhờ nó bạn không phải tự cài Python. Trang chính thức: https://docs.astral.sh/uv/. Lệnh cài có ở Bước 1.

Tài khoản và khóa:

• Khóa OpenRouter (cho cách dùng giao diện web): OpenRouter là dịch vụ trung gian cho thuê nhiều mô hình AI qua một khóa duy nhất. Đăng ký tại https://openrouter.ai. Khóa có dạng bắt đầu bằng sk-or-. Bạn trả tiền cho OpenRouter theo lượng dùng; giá từng mô hình xem trên trang của họ.
• Nếu bạn chỉ gắn nó vào một trợ lý có sẵn (Claude Code, Codex, Gemini CLI) thì không cần khóa OpenRouter. Khi đó trợ lý dùng mô hình mà bạn đang trả tiền cho nó.

Lưu ý: Mỗi lượt làm việc, toàn bộ nội dung trao đổi trước đó được gửi lại cho mô hình, nên một việc nhiều bước tốn hơn nhiều so với một câu hỏi chat. Hãy chỉ nạp một khoản nhỏ vào OpenRouter khi mới thử.

3. Cài đặt từng bước

Có hai cách dùng. Cách 1 (giao diện web) dễ nhất cho người mới: một bên là khung chat, một bên là trình duyệt đang chạy. Cách 2 dành cho người đã có trợ lý AI dạng dòng lệnh.

Bước 1: Cài uv

Windows, chạy trong PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

Kiểm tra:

uv --version

Thấy gì là đúng: một dòng có chữ uv kèm số phiên bản.

Bước 2: Lấy khóa OpenRouter

Đăng nhập https://openrouter.ai, tạo một khóa API và chép lại. Khóa này giống mật khẩu ví tiền: không dán vào chat, không gửi cho ai.

Bước 3: Lưu khóa vào file .env

Tạo một thư mục riêng, ví dụ tro-ly-web. Trong thư mục đó, tạo file tên đúng là .env với một dòng (thay phần sau dấu bằng bằng khóa thật của bạn):

OPENROUTER_API_KEY=sk-or-...

Cách này an toàn hơn gõ khóa thẳng vào lệnh. README giải thích: khóa gõ trong lệnh sẽ nằm lại trong lịch sử dòng lệnh. Phần mềm chỉ đọc file .env ở đúng thư mục bạn đang đứng khi chạy lệnh.

Bước 4 (Cách 1): Mở giao diện web

Đứng trong thư mục có file .env rồi chạy:

uvx invisible-playwright-mcp ui

Lần đầu sẽ lâu vì phải tải phần mềm và lõi trình duyệt. Sau đó mở trình duyệt thường của bạn và vào:

http://127.0.0.1:8765

Thấy gì là đúng: một trang có khung chat bên trái và khung trình duyệt bên phải. Dòng khởi động trong cửa sổ lệnh liệt kê tên các biến nó đã đọc được (không in ra giá trị khóa).

Nếu không muốn tạo file .env, bạn có thể truyền khóa trực tiếp, chấp nhận việc khóa nằm trong lịch sử lệnh:

uvx invisible-playwright-mcp ui --openrouter-key sk-or-...

Bước 4 (Cách 2): Gắn vào trợ lý AI có sẵn

Sau khi xong Bước 1, chạy lệnh ứng với trợ lý bạn dùng.

Claude Code:

claude plugin marketplace add feder-cr/invisible_playwright_mcp
claude plugin install invisible-playwright-mcp@feder-cr

Codex:

codex plugin marketplace add feder-cr/invisible_playwright_mcp
codex plugin add invisible-playwright-mcp@feder-cr

Gemini CLI:

gemini extensions install https://github.com/feder-cr/invisible_playwright_mcp

Thấy gì là đúng: chạy claude plugin list, codex mcp list hoặc gemini extensions list và thấy tên công cụ trong danh sách. Tài liệu nhấn mạnh: "đã thêm" chưa có nghĩa là "đã kết nối", nên hãy kiểm tra bằng các lệnh này.

Với Claude Desktop, Cursor và các ứng dụng dùng file cấu hình, thêm khối sau vào file cấu hình MCP của ứng dụng (vị trí file từng ứng dụng có trong trang wiki "The MCP server" của dự án):

{
  "mcpServers": {
    "stealth": {
      "command": "uvx",
      "args": ["invisible-playwright-mcp"]
    }
  }
}

4. Dùng lần đầu

Với giao diện web ở http://127.0.0.1:8765:

1. Gõ một việc đơn giản, chỉ đọc, vào khung chat. Ví dụ: "Mở trang https://example.com và cho tôi biết tiêu đề cùng đoạn văn đầu tiên."
2. Nhìn khung bên phải: trình duyệt tự mở trang, con trỏ tự di chuyển và phím tự được gõ như có người đang dùng.
3. Khi xong, trợ lý trả lời bằng chữ trong khung chat.

Sau khi quen, thử việc có nhiều bước hơn. Mẹo viết yêu cầu theo tinh thần của README: nói rõ trang nào, cần đọc gì, làm theo thứ tự nào, và dặn "nếu không có dữ liệu thì nói là không có, đừng đoán".

Vài tùy chọn hữu ích khi chạy lệnh ui:

Tùy chọn	Tác dụng
--model	Chọn mô hình khác trên OpenRouter. Mặc định là z-ai/glm-5.3-flash
--profile-dir	Chỉ định thư mục lưu hồ sơ trình duyệt, để lần sau vẫn còn đăng nhập và cookie
--headed	Hiện cả cửa sổ trình duyệt thật (giao diện web vốn đã cho bạn xem trang)
--port	Đổi cổng khi 8765 đang bận
--proxy	Đi qua máy chủ trung gian của riêng bạn; phải ghi đủ địa chỉ và cổng

Lưu ý: Không có giới hạn số bước cho một việc. Nếu mô hình đi lòng vòng, nó vẫn tiếp tục và vẫn tính tiền. Hãy ngồi xem trong những lần đầu và dừng khi thấy bất thường. Đừng đổi --host khỏi 127.0.0.1: giao diện không có đăng nhập, mở ra mạng là ai cũng điều khiển được.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Gõ uv hoặc uvx báo không nhận ra lệnh	Cửa sổ dòng lệnh chưa biết nơi cài uv	Chạy lại dòng thứ hai ở Bước 1 (dòng đặt Path trên Windows, dòng source trên Linux), hoặc đóng và mở lại cửa sổ
Chạy trên máy Mac không khởi động được trình duyệt	Lõi trình duyệt không có bản cho macOS	Dùng máy Windows hoặc Linux
Lần đầu chạy rất lâu, tưởng bị treo	Đang tải lõi trình duyệt (khoảng 240 MB trên Windows) từ GitHub	Chờ tải xong. Kiểm tra mạng và dung lượng ổ cứng
Trợ lý trả lời "the main browser is not open. Call browser_open to open it."	Khi dùng qua MCP, phải mở trình duyệt trước khi làm việc khác	Bảo trợ lý mở trình duyệt (công cụ browser_open) rồi làm tiếp
Trợ lý trả lời "the main browser is gone: it closed or crashed..."	Cửa sổ trình duyệt bị đóng tay hoặc bị lỗi	Bảo trợ lý mở lại. Nó quay lại với cùng danh tính cũ
Đã cài plugin nhưng trợ lý không có công cụ trình duyệt	Thiếu uv, gõ sai cấu hình, hoặc lõi chưa tải xong	Kiểm tra bằng claude plugin list, codex mcp list, gemini extensions list; khởi động lại trợ lý
Không mở được http://127.0.0.1:8765	Lệnh ui chưa chạy xong, đã bị tắt, hoặc cổng 8765 bị chương trình khác dùng	Xem cửa sổ lệnh còn chạy không; thử thêm --port với một số khác
Trang web vẫn chặn hoặc hiện captcha	Công cụ chỉ lo phần "trình duyệt trông bình thường". Địa chỉ mạng bị nghi ngờ, gửi quá nhiều yêu cầu, hay thao tác quá đều vẫn bị chặn	Làm chậm lại, giảm số lần. Trang wiki "Why does my AI agent get blocked?" giải thích bốn lớp nguyên nhân
Tiền OpenRouter hết nhanh	Mỗi lượt gửi lại toàn bộ nội dung trước đó, việc càng dài càng tốn	Chia việc nhỏ, bắt đầu cuộc trò chuyện mới cho việc mới, dùng mô hình rẻ

6. Gỡ cài đặt / cập nhật

Cập nhật: uvx giữ lại bản đã tải lần trước. Để chạy bản mới nhất, thêm @latest sau tên gói (cú pháp chuẩn của uv):

uvx invisible-playwright-mcp@latest ui

Bản mới nhất tại thời điểm viết là v0.70.2 (ngày 25/9/2026). Dự án ra bản mới rất thường xuyên; xem trang Releases của repo.

Gỡ:

1. Tắt lệnh đang chạy bằng Ctrl+C.
2. Xóa thư mục dữ liệu, nơi lưu phiên làm việc, hồ sơ và ảnh chụp màn hình. Trên Windows là thư mục invisible-playwright-mcp trong %APPDATA%; trên Linux là invisible-playwright-mcp trong $XDG_DATA_HOME.
3. Xóa thư mục chứa file .env của bạn.
4. Dọn phần uv đã tải về bằng lệnh chuẩn của uv:

uv cache clean

5. Nếu đã gắn vào trợ lý AI, gỡ plugin hoặc extension theo hướng dẫn của chính trợ lý đó, hoặc xóa khối stealth khỏi file cấu hình.
6. Vào OpenRouter và thu hồi khóa nếu không dùng nữa.

7. Câu hỏi hay gặp

Có mất tiền không? Phần mềm thì không. Mô hình AI thì có: giao diện web dùng khóa OpenRouter của bạn và bạn trả theo lượng dùng. Nếu gắn vào trợ lý có sẵn, chi phí tính vào gói bạn đang trả cho trợ lý đó.

Dữ liệu có bị gửi đi đâu không? Theo mục Privacy Policy trong README: công cụ chạy trên máy bạn và không có máy chủ riêng. Những thứ rời khỏi máy là: các trang bạn truy cập thấy trình duyệt; nhà cung cấp mô hình (OpenRouter) nhận nội dung trò chuyện và những gì trợ lý đọc trên trang; GitHub thấy địa chỉ IP của bạn khi tải lõi trình duyệt và một file đếm lượt mở. Không có gì gửi về tác giả. Phiên làm việc và ảnh chụp lưu trên máy bạn.

Có nên cho nó đăng nhập tài khoản của tôi không? Cẩn thận. Tài liệu của dự án nói rõ: một phiên đã đăng nhập cho trợ lý làm được mọi thứ bạn làm được, kể cả bấm nhầm. Hãy dùng hồ sơ riêng, thử việc chỉ đọc trước, và tự xem lại trước khi gửi bất cứ thứ gì.

Nó có tự nộp đơn xin việc như AIHawk cũ không? README hiện tại không có tính năng hay hướng dẫn nào riêng cho việc đó. Đây là trợ lý lướt web đa dụng; bạn ra yêu cầu nào thì nó làm theo yêu cầu đó. Dự án dặn: đọc điều khoản của trang bạn dùng, tôn trọng giới hạn tần suất, và không gửi đi thứ gì mà con người chưa đọc.

Máy yếu có chạy được không? Mô hình AI chạy trên máy chủ của nhà cung cấp, không chạy trên máy bạn. Máy bạn chỉ cần chạy nổi một trình duyệt Firefox và còn đủ ổ cứng cho lõi trình duyệt. Dự án không công bố cấu hình tối thiểu.