Ưu, nhược và chỗ chưa rõ
| Ưu | Có script thật đo thay vì chỉ đoán: pagespeed_check.py, crux_history.py, gsc_query.py gọi API của Google khi bạn cấp key miễn phí, nên Core Web Vitals là số đo từ người dùng thật. | README, FAQ "Do I need API keys?" |
|---|---|---|
| Ưu | Tác giả sửa các lỗ hổng người dùng báo: issue #7 chỉ ra lỗi SSRF, đường dẫn ghi file không kiểm tra và pip --break-system-packages; bản 1.2.0 đã chặn IP nội bộ, kiểm tra đường dẫn và chuyển sang venv riêng. | Issue #7 |
| Ưu | Script cài tay tự ghim vào tag v2.5.0 chứ không lấy main, và README khuyên clone về đọc trước thay vì chạy curl | bash. | install.sh dòng 10-15 |
| Nhược | Audit toàn site tốn nhiều lượt dùng Claude: README ghi năm agent chạy trên Opus, phần còn lại trên Sonnet. Ở bản 2.2.5, 10 trên 11 agent con hết lượt (maxTurns) trước khi ghi kết quả, người dùng phải chạy lại từng cái. | Issue #272 |
| Nhược | Hook soát schema bị crash khi @type là một mảng (ví dụ ["LocalBusiness", "FinancialService"]), và crash thì cả file không được soát. Issue còn mở, và dòng 231 của validate-schema.py ở commit mình đọc vẫn còn lỗi này. | Issue #357 (đang mở) |
| Nhược | Trang dựng bằng JavaScript (SPA) từng cho kết quả sai: agent con báo lỗi không có thật vì chỉ đọc HTML gốc. | Issue #60 |
| Chưa rõ | README ghi có hai bản: bản công khai MIT này và một bản riêng cho thành viên AI Marketing Hub Pro (trả phí) được tính năng mới sớm hơn. Mình chỉ đọc được bản công khai, nên không biết hai bản khác nhau bao nhiêu. | README, Install, "Two versions" |
| Chưa rõ | Đường cài plugin lấy bản mới nhất từ marketplace và cập nhật theo đó, không ghim được commit. Chỉ đường cài tay mới giữ đúng tag v2.5.0. | README, Install |
Khi nên dùng
- Bạn cần audit SEO sâu cho một site thật, có số đo từ API Google, kiểm tra schema, hreflang, local SEO, và chấp nhận cài Python cùng Chromium.
Khi không nên dùng
- Bạn đang dùng gói Claude có hạn mức thấp, site là SPA dựng hoàn toàn bằng JavaScript, hoặc bạn không muốn một hook chạy sau mỗi lần agent sửa file.
Cách cài
Claude Code (plugin)
/plugin marketplace add AgriciDaniel/claude-seo && /plugin install claude-seo@agricidaniel-claude-seo && /seo setupClaude Code (cài tay, macOS/Linux)
git clone --depth 1 --branch v2.5.0 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.shClaude Code (cài tay, Windows)
git clone --depth 1 --branch v2.5.0 https://github.com/AgriciDaniel/claude-seo.git; powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1Nó chạm vào những gì
- File đọc và ghi
- Cài tay: chép skill vào ~/.claude/skills/ và agent vào ~/.claude/agents/. /seo setup tạo một môi trường Python riêng (.venv) và tải Chromium vào thư mục dữ liệu của plugin (Windows: %LOCALAPPDATA%\claude-seo). Báo cáo được ghi thành file trong project.
- Gọi mạng
- Trang web bạn kiểm tra (qua url_safety.py chặn IP nội bộ); PyPI và máy chủ tải Chromium của Playwright lúc setup; googleapis.com khi bạn bật API Google; Wikipedia, Reddit, Common Crawl cho vài phép kiểm tra; các API trả phí chỉ khi bạn bật extension. PRIVACY.md ghi không có telemetry, và mình không thấy host theo dõi nào khi tìm trong scripts/ và hooks/.
- Script lúc cài
- install.sh / install.ps1 clone tag v2.5.0 rồi chạy scripts/claude-seo setup: tạo venv, pip install -r requirements.txt, python -m playwright install chromium.
- Tiến trình
- Một hook PostToolUse chạy sau mỗi lần Edit hoặc Write: node hooks/run-python-hook.js gọi hooks/validate-schema.py để soát JSON-LD trong file vừa sửa (chỉ đọc file, không gọi mạng). Khi audit, các script Python và Chromium headless chạy để tải và chụp trang.
Đọc từ: hooks.json, run-python-hook.js, install.sh#L8-L37, runtime.py#L120-L136, runtime.py#L314-L340, PRIVACY.md
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin