url-labeler 1.3.0

Claude Code plugin: đánh nhãn URL cho phân tích organic traffic theo chủ đề (SEO). Hỗ trợ đến 75,000 hàng.

url-labeler

Công cụ đánh nhãn URL theo chủ đề nội dung cho phân tích organic traffic SEO.
Chạy trong Claude Desktop App hoặc Claude Code — không cần viết code.

Hỗ trợ đến 75,000 hàng. Kết hợp rule-based (miễn phí) + Claude Batch API (~$0.02–0.10).

---

Cài đặt

Yêu cầu

• Python 3.9+
• Claude Desktop App hoặc Claude Code

2 lệnh là xong

pip install url-labeler
url-labeler-install

Lệnh url-labeler-install tự động cấu hình tất cả:

Môi trường	Sau khi cài	Cần thêm
Claude Desktop App	✅ Sẵn sàng	Tắt + mở lại App
Claude Code — MCP tools	✅ Sẵn sàng	Không
Claude Code — slash commands	✅ Sẵn sàng	Mở terminal mới

Sau khi chạy url-labeler-install

Claude Desktop App:

1. Tắt hoàn toàn (Cmd+Q trên Mac, không chỉ đóng cửa sổ)
2. Mở lại — biểu tượng 🔧 trong chat = cài đặt thành công

Claude Code:

• MCP tools hoạt động ngay, không cần làm gì thêm
• Slash commands (/url-labeler:start): mở terminal mới, hoặc chạy source ~/.zshrc

---

Cài đặt thủ công (nếu muốn)

Mở rộng để xem

Claude Desktop App

Thêm vào file cấu hình:

Hệ điều hành	Đường dẫn
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "url-labeler": {
      "command": "url-labeler-server"
    }
  }
}

Claude Code

Thêm vào ~/.claude/settings.json:

{
  "mcpServers": {
    "url-labeler": {
      "command": "url-labeler-server"
    }
  }
}

Để dùng slash commands, thêm vào ~/.zshrc hoặc ~/.bashrc:

function claude() { command claude --plugin-dir ~/.local/share/url-labeler/plugin "$@"; }

---

Sử dụng

Cách đơn giản nhất

Trong Claude Desktop App hoặc Claude Code, gõ:

Đánh nhãn file URL này cho tôi: /Users/ten/data.csv

hoặc với Google Sheets:

Đánh nhãn file URL này cho tôi: https://docs.google.com/spreadsheets/d/ID/edit

Claude sẽ hỏi 4 câu ngắn rồi tự xử lý:

1. Tên thương hiệu
2. Domain
3. Mục đích phân tích
4. Nhãn mẫu bạn muốn dùng

Slash commands (Claude Code)

/url-labeler:start          # Chạy toàn bộ pipeline (khuyến nghị)
/url-labeler:build-labels   # Chỉ xây danh sách nhãn
/url-labeler:label-data     # Chỉ đánh nhãn
/url-labeler:review-labels  # Chỉ review kết quả

Kết quả lưu tại ./labeled_output.xlsx (có thể chỉ định đường dẫn khác).

---

Định dạng dữ liệu đầu vào

File CSV / Excel / Google Sheets cần có 3 cột (tên cột nhận dạng tự động):

URL	Keywords	Organic Traffic
https://example.com/	trang chủ	5000
https://example.com/may-giat/	máy giặt lg	1200

Google Sheets: chia sẻ ở chế độ "Anyone with the link can view".

---

API Key

Lần đầu chạy, Claude sẽ hỏi Anthropic API key.
Lấy key tại: console.anthropic.com → API Keys

Key được lưu tại ~/.anthropic_key — các lần sau không cần nhập lại.

---

Hiệu suất & Chi phí

Số URL	Rule-based	Claude Batch API	Chi phí API
5,000	< 2 giây	10–15 phút	~$0.005
20,000	< 2 giây	15–20 phút	~$0.02
75,000	< 3 giây	20–40 phút	~$0.08

85–90% hàng xử lý bằng rule-based (miễn phí). Chỉ phần còn lại gọi Claude API.

---

License

MIT © maytinh