Kho Repo
Dành cho AI agent

API & MCP của Kho Repo

Kho hiện có 1.018 repo trong 34 chủ đề. Mọi endpoint đọc đều mở CORS, không cần khoá, và trả về mô tả tiếng Việt kèm mô tả gốc từ GitHub.

Bắt đầu nhanh

Bắt đầu bằng việc mô tả nhu cầu của bạn. Agent gọi một endpoint, nhận về danh sách repo kèm lý do khớp:

# Tìm repo theo nhu cầu (tiếng Việt hoặc tiếng Anh)
curl "https://repo.shopkitai.com/api/v1/search?q=cao+dữ+liệu+web+cho+RAG&limit=5"

# Lấy chi tiết một repo
curl "https://repo.shopkitai.com/api/v1/repos/firecrawl/firecrawl"

# Lọc theo chủ đề + ngôn ngữ
curl "https://repo.shopkitai.com/api/v1/repos?topic=scrape&language=Python&sort=stars&per_page=10"

Tìm theo tình huống dự án

Khi bạn không biết cần tìm gì, dùng tham số use_case — kho sẽ tự chọn các chủ đề liên quan:

build-webBuild web app

Frontend, backend, UI, biểu đồ, API, cào dữ liệu, triển khai.

curl "https://repo.shopkitai.com/api/v1/search?use_case=build-web&limit=8"
build-ai-agentBuild AI agent

Framework agent, MCP, skill/prompt, bộ nhớ, nền tảng LLM.

curl "https://repo.shopkitai.com/api/v1/search?use_case=build-ai-agent&limit=8"
build-storeBuild store dropship

Storefront headless, mẫu Shopify/Stripe, giỏ hàng, hiệu ứng, triển khai.

curl "https://repo.shopkitai.com/api/v1/search?use_case=build-store&limit=8"
scrape-webCào dữ liệu web

Thư viện cào web, trình duyệt tự động, nguồn API công khai.

curl "https://repo.shopkitai.com/api/v1/search?use_case=scrape-web&limit=8"
rag-llmRAG / ứng dụng LLM

Nền tảng RAG, vector store, mô hình ngôn ngữ, xử lý tài liệu.

curl "https://repo.shopkitai.com/api/v1/search?use_case=rag-llm&limit=8"
self-hostTự host & triển khai

Giải pháp self-hosted, container, giám sát hệ thống.

curl "https://repo.shopkitai.com/api/v1/search?use_case=self-host&limit=8"
learnHọc & lộ trình

Sách, lộ trình, phỏng vấn, danh sách awesome.

curl "https://repo.shopkitai.com/api/v1/search?use_case=learn&limit=8"
mediaẢnh / video / âm thanh

Sinh ảnh, giọng nói, dựng video, OCR, thị giác máy tính.

curl "https://repo.shopkitai.com/api/v1/search?use_case=media&limit=8"

Endpoint đọc

MethodPathMô tả
GET/api/v1/searchTìm theo mô tả tự nhiên, có lý do khớp và gợi ý chủ đề.
GET/api/v1/reposDuyệt / lọc / phân trang danh sách repo.
GET/api/v1/repos/{owner}/{name}Chi tiết một repo kèm repo liên quan.
GET/api/v1/topicsToàn bộ chủ đề, nhóm chủ đề và ngôn ngữ.
GET/api/v1/languagesDanh sách ngôn ngữ lập trình trong kho.
GET/api/v1/statsTổng quan kho: số repo, chủ đề, sao.
GET/api/v1/store/planKế hoạch dựng store bán hàng dropship theo vai trò.
GET/openapi.jsonOpenAPI 3.1 document đầy đủ.
GET/llms.txtManifest dạng văn bản cho agent.

Tham số /api/v1/repos

Tham sốKiểuÝ nghĩa
qstringTừ khoá tìm kiếm, không phân biệt dấu tiếng Việt.
topicstringID hoặc tên chủ đề (ví dụ scrape, agent, frontend).
languagestringNgôn ngữ chính của repo.
ownerstringTên tổ chức / chủ sở hữu.
min_starsintegerNgưỡng số sao tối thiểu.
sortstringstars | newest | name | updated | relevance.
page / per_pageintegerPhân trang, per_page tối đa 100.
fieldsstringChỉ trả về các trường cần, ví dụ name,url,summary.

Cập nhật kho theo yêu cầu

Kho được cập nhật khi có yêu cầu. Các endpoint ghi cần header X-Api-Key trùng với biến môi trường KHO_REPO_ADMIN_KEY.

MethodPathMô tả
POST/api/v1/reposThêm repo mới vào kho (tự lấy metadata từ GitHub).
PATCH/api/v1/repos/{owner}/{name}Sửa mô tả, chủ đề, điểm nổi bật.
DELETE/api/v1/repos/{owner}/{name}Xoá repo khỏi kho.
POST/api/v1/repos/{owner}/{name}/refreshLàm mới số sao & ngày push từ GitHub.
# Thêm repo mới — tự lấy mô tả, ngôn ngữ, số sao và tự suy luận chủ đề
curl -X POST "https://repo.shopkitai.com/api/v1/repos" \
  -H "X-Api-Key: $KHO_REPO_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"repo":"microsoft/playwright","summary":"Playwright giúp kiểm thử và tự động hoá trình duyệt."}'

# Sửa mô tả tiếng Việt của một repo
curl -X PATCH "https://repo.shopkitai.com/api/v1/repos/microsoft/playwright" \
  -H "X-Api-Key: $KHO_REPO_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"scrape","highlights":["Chạy Chromium, Firefox, WebKit."]}'

Kế hoạch dựng store bán hàng

Kho không chỉ lưu repo, mà còn trả về kế hoạch dựng store để AI agent tự động hoá việc dựng cửa hàng. Endpoint này tự chọn repo trong kho cho từng vai trò (storefront, design system, giỏ hàng, hiệu ứng, carousel, hosting…), kèm lệnh cài đặt, gợi ý kỹ thuật và checklist ra mắt store.

# Kế hoạch dựng store theo nền tảng
curl "https://repo.shopkitai.com/api/v1/store/plan?platform=shopify"

# Chỉ lấy một vai trò
curl "https://repo.shopkitai.com/api/v1/store/plan?role=cart"

# platform: shopify (Hydrogen headless) | stripe (tự host) | nextjs (thuần)
# role: storefront | storefront-skills | design-system | animation | cart | carousel | hosting | product-media
Vai tròDùng để
storefrontNền tảng dựng trang cửa hàng: danh mục, sản phẩm, checkout.
storefront-skillsSkill cho AI agent viết đúng chuẩn Storefront API, clone landing page.
design-systemBộ component giao diện dùng chung cho mọi trang.
animationHiệu ứng 3D, Bento Grid, Marquee, shimmer cho hero và trang sản phẩm.
cartGiỏ hàng trượt kèm thanh free shipping và upsell 1-click.
carouselDải video UGC 9:16 tự động phát để tăng tỷ lệ chốt đơn.
hostingFramework chạy production và cách deploy store.
product-mediaCông cụ tạo ảnh sản phẩm, video unbox, ảnh nền landing page.

Trên MCP server, agent gọi tool plan_store với tham số platform và role, hoặc dùng search_repos với use_case=build-store.

Kết nối MCP server

MCP server chạy ở chế độ stateless, hỗ trợ Streamable HTTP. Agent dùng được 6 tool: search_repos, get_repo, list_topics, get_stats, plan_store và add_repo.

# Claude Code
claude mcp add --transport http kho-repo https://repo.shopkitai.com/mcp

# Cursor / agent khác dùng cấu hình JSON
{
  "mcpServers": {
    "kho-repo": { "type": "http", "url": "https://repo.shopkitai.com/mcp" }
  }
}

Định dạng phản hồi

{
  "data": [
    {
      "name": "firecrawl/firecrawl",
      "url": "https://github.com/firecrawl/firecrawl",
      "topic": "Thu thập dữ liệu & Trình duyệt tự động",
      "topic_id": "scrape",
      "language": "TypeScript",
      "stars": 202341,
      "summary": "🔥 The API to search, scrape, and interact with the web for AI",
      "description": "Mô tả gốc từ GitHub",
      "highlights": ["…"],
      "why_match": "Khớp ở: tên repo, mô tả tiếng Việt"
    }
  ],
  "meta": {
    "total": 23,
    "page": 1,
    "per_page": 24,
    "total_pages": 1
  }
}

Chủ đề có sẵn

AI Agent & MCP72Trợ lý lập trình AI51Skill, Prompt & Mẫu cho AI63Bộ nhớ, Ngữ cảnh & Tiết kiệm token25Nền tảng AI, RAG & Workflow71Mô hình AI & Huấn luyện64AI Ảnh, Giọng nói & Deepfake46Dựng video & Slide tự động34Tài liệu, OCR & Thị giác máy tính38Học AI & Machine Learning68Thu thập dữ liệu & Trình duyệt tự động23API & Dịch vụ dữ liệu7Ngôn ngữ & Runtime18Framework Backend31Framework Frontend24Thư viện giao diện & CSS13Đồ họa, 3D & Sơ đồ21Editor, Terminal & Dòng lệnh45Ứng dụng đa nền tảng & Game14Container & DevOps24Giám sát, CSDL & Phân tích32Tự host & Nhà thông minh10Bảo mật & Hack17Tài chính & Crypto14Tiện ích Windows & Hệ thống25Tải & phát Video, Nhạc14Năng suất, Ghi chú & Việc làm40Sách, Khóa học & Lộ trình36Thuật toán & Phỏng vấn18Danh sách Awesome & Tổng hợp37Quy chuẩn & Thực hành tốt7Khác5Store & Dropship E-commerce5Hiệu ứng & Animation UI6