Treg: OpenRouter cho các công cụ agent — một token, hàng ngàn API không cần đăng ký

Treg - OpenRouter cho các công cụ agent

Treg vừa ra mắt như một giải pháp đáng chú ý cho cộng đồng phát triển agent AI: một nền tảng đóng vai trò trung gian giữa agent và hàng ngàn công cụ bên ngoài, tương tự cách OpenRouter làm với các mô hình ngôn ngữ lớn. Thay vì phải đăng ký từng tài khoản nhà cung cấp, người dùng chỉ cần một địa chỉ URL và một token duy nhất.

Vấn đề mà Treg giải quyết

Các công cụ mà agent cần cho công việc thực tế thường nằm sau những gói thuê bao đắt đỏ mà không ai muốn mua chỉ để dùng một lần. Chẳng hạn:

• Semrush: 139 USD/tháng
• Moz: 99 USD/tháng
• Crunchbase: 99 USD/tháng
• Apollo: 59 USD/người dùng

Đáng chú ý hơn, nhiều dịch vụ còn không có API công khai — chỉ dành cho đối tác, chỉ theo lời mời, hoặc yêu cầu quy trình xét duyệt ứng dụng phức tạp. Treg đứng ra gánh các tài khoản này và tính phí người dùng theo từng lần gọi, chỉ từ vài phần trăm của một xu.

Triết lý cốt lõi: hãy yêu cầu công việc, không phải công cụ. Bạn không cần biết nhà cung cấp nào bán dữ liệu backlink, cũng không cần có tài khoản với họ. Chỉ cần tìm việc mình muốn làm, đọc giá, rồi gọi.

Hai loại công cụ, một token duy nhất

Treg phân biệt rõ hai nhóm công cụ:

Danh mục công khai (catalog) — các endpoint bên ngoài mà Treg có thể phục vụ bằng khóa riêng của mình hoặc qua tuyến công khai đã xác minh không cần khóa nhà cung cấp. Các lệnh gọi bằng khóa của Treg sẽ trừ vào số dư trả trước của nhóm, còn các lệnh gọi ẩn danh thì miễn phí.

Công cụ riêng của bạn — bất cứ thứ gì mà thành viên trong nhóm đã đăng ký: tài khoản API trả phí, kết nối OAuth, CLI của nhà cung cấp, hoặc file SKILL.md. Khóa riêng của bạn luôn được ưu tiên hơn khóa của Treg và những lệnh gọi này không bị tính phí.

Cần làm rõ hệ thống thuật ngữ ở nửa sau:

• endpoint: một base_url thượng nguồn kèm các liên kết thông tin xác thực (mỗi liên kết tiêm một secret vào request)
• CLI: một binary của nhà cung cấp (stripe, gh, vercel…) chạy với thông tin xác thực được tiêm vào
• skill / bundle: một công thức (SKILL.md) cùng các secret và công cụ của nó, đăng ký chung một gói

Nguyên tắc xuyên suốt: proxy chỉ chuyển tiếp chứ không mô phỏng thượng nguồn, và tiêm xác thực ở phía máy chủ — nhờ đó hệ thống vẫn hoạt động khi API thượng nguồn thay đổi, còn người gọi thì không bao giờ phải giữ khóa.

Bắt đầu sử dụng

Quy trình khởi đầu khá đơn giản và không cần cấu hình phức tạp:

# 1. cài CLI, đồng thời trỏ nó về registry
curl -fsSL https://treg.to/install.sh | sh

# 2. đăng nhập (mặc định qua GitHub, hoặc --email / --token cho agent và CI)
treg login

# 3. dùng ngay — không cần khóa, không cần đăng ký gì
treg catalog search "backlinks for a domain"
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance

Có thể tìm công cụ theo chức năng thay vì theo tên nhà cung cấp. Chỉ cần gõ việc cần làm, Treg sẽ trả về các endpoint phù hợp kèm mức giá cụ thể. Đặc biệt, Treg còn có thể cài như một plugin cho Claude Code:

/plugin marketplace add superdesigndev/treg
/plugin install treg@treg

Plugin này cài đặt mà không cần token hay cấu hình, và trong lần chạy đầu tiên sẽ tự động hướng dẫn agent qua các bước còn lại.

Thang bậc xác thực khi gọi công cụ

Khi gọi một endpoint trong danh mục, Treg phục vụ theo thứ tự ưu tiên sau:

1. Nhóm bạn đã đăng ký công cụ riêng cho nhà cung cấp đó → dùng công cụ và khóa đó
2. Nhóm bạn đã lưu secret cho nhà cung cấp → tiêm qua công cụ ảo
3. Không có cả hai, nhưng endpoint có tuyến công khai đã xác minh → miễn phí, không cần khóa
4. Còn lại → dùng khóa riêng của Treg, trừ vào số dư trả trước

Thông tin xác thực của bạn luôn thắng khóa của Treg. Vì vậy, kết nối khóa mà bạn đã trả phí sẽ giúp các lệnh gọi đó không bị trừ vào số dư nữa. Đáng chú ý, một endpoint mà Treg chưa công bố giá sẽ bị từ chối chứ không được phục vụ miễn phí — thay vào đó bạn được yêu cầu tự kết nối khóa của mình.

Chia sẻ và sử dụng công cụ của riêng bạn

Đường dẫn ít suy nghĩ nhất là để Treg tự phát hiện những gì có thể chia sẻ trong dự án:

treg scan     # xem trước: khóa, skill và CLI mà upload sẽ đăng ký
treg upload   # đăng ký chúng (mã hóa phía máy chủ)

Lệnh treg upload sẽ quét file .env (đối chiếu với khoảng 80 nhà cung cấp đã biết), mọi thư mục skill con, và các CLI trong danh mục đã cài. Có ba loại đối tượng được đưa vào registry với cách chia sẻ riêng:

• Endpoints (API HTTP): chia sẻ một URL thượng nguồn có thể gọi bằng khóa đã lưu, hoặc hàng loạt từ file .env
• CLIs: Treg tự phát hiện và đăng ký các CLI đã cài như stripe, gh, vercel
• Skills: đăng ký cả một năng lực hoàn chỉnh gồm công thức, secret và công cụ đi kèm

Điểm đáng giá về mặt kiến trúc là cách dùng endpoint theo kiểu thuận tự nhiên cho agent: xây dựng request thượng nguồn thực rồi thêm tiền tố proxy. Treg phân giải công cụ theo host, tiêm thông tin xác thực và chuyển tiếp mọi thứ còn lại một cách trung thực — token X-Treg-Token của bạn được loại bỏ trước khi thượng nguồn nhìn thấy.

Kiến trúc và tự triển khai

Treg hoàn toàn có thể tự triển khai (self-host). Chạy cục bộ chỉ cần một lệnh duy nhất, yêu cầu tmux và uv:

scripts/dev-local.sh up   # server trên http://localhost:18790

Đối với môi trường sản xuất, gói cài đặt có phần mở rộng server:

pip install "tools-registry[server]"

Cần lưu ý rằng bản thân gói pip install tools-registry chỉ cung cấp CLI để nói chuyện với registry có sẵn; muốn vận hành một registry thì phải cài kèm phần server với FastAPI, driver cơ sở dữ liệu và mã hóa.

Về kiến trúc, luồng xử lý cho mỗi lệnh gọi diễn ra như sau: phân giải công cụ → giải mã secret → áp dụng injector của từng liên kết → truyền phát tới thượng nguồn → ghi audit theo kiểu fire-and-forget. Hạ tầng chuyển tiếp chỉ truyền byte mà không xử lý logic nghiệp vụ, giúp hệ thống gọn nhẹ và dễ bảo trì.

Hợp đồng chuyển tiếp trung thực: proxy chỉ thay đổi đúng ba thứ — header vận chuyển từng chặng, các header điều khiển và chuyển tiếp riêng của Treg (bị loại bỏ hoàn toàn), và thông tin xác thực được tiêm vào. Mọi thứ khác giữ nguyên xi.

Có bốn dạng xác thực cho mỗi liên kết: env (chuỗi thuần hoặc API key), secret_file (file token JSON, trích một trường), oauth (token OAuth JSON, tự động làm mới nếu có thể), và cli_auth (lấy từ keychain của CLI).

Giấy phép và lộ trình

Treg được phát hành theo giấy phép Apache 2.0 kèm điều khoản bổ sung. Bạn có thể dùng tự do, kể cả cho mục đích thương mại và trong nội bộ tổ chức — việc tự triển khai registry riêng được khuyến khích. Hạn chế duy nhất là không được phân phối lại mã nguồn cho bên thứ ba dưới dạng dịch vụ registry cạnh tranh mà không có sự cho phép bằng văn bản. Tuy nhiên, việc dùng API treg.to trong sản phẩm của riêng bạn với tính phí chuyển tiếp thì được phép.

Lộ trình sắp tới bao gồm hỗ trợ MCP, các cấp quyền chi tiết hơn, tăng cường bảo vệ quản lý khóa khi lưu trữ, và có thể là sáp nhập với Loopni.

Với các nhóm phát triển agent AI tại Việt Nam, Treg mở ra một hướng tiếp cận thực tế: giảm đáng kể chi phí tích hợp hàng chục API khác nhau, đồng thời giải quyết bài toán quản lý thông tin xác thực tập trung cho cả nhóm. Việc hỗ trợ tự triển khai cũng giúp các doanh nghiệp có yêu cầu khắt khe về dữ liệu có thể kiểm soát toàn bộ luồng xử lý trong hạ tầng của mình.