# 获取 frontend-indie-dev 人群的所有工作流套装（第一页）
curl -X GET "https://api.emirahub.dev/api/v1/prompts?persona=frontend-indie-dev&limit=20" \
  -H "Authorization: Bearer em_your_api_key_here"

import httpx

client = httpx.Client(headers={"Authorization": "Bearer em_your_api_key_here"})

# 列出工作流套装
resp = client.get(
    "https://api.emirahub.dev/api/v1/prompts",
    params={"persona": "frontend-indie-dev", "limit": 20}
)
data = resp.json()
print(f"共 {data['total']} 个 Kit")
for kit in data["data"]:
    print(kit["id"], "-", kit["title"])

# 获取单个 Kit 完整内容（含 prompts 数组）
kit_id = data["data"][0]["id"]
detail = client.get(f"https://api.emirahub.dev/api/v1/prompts/{kit_id}").json()
for step in detail["prompts"]:
    print(f"Step {step['step']} [{step['role']}]: {step['title']}")

const BASE = "https://api.emirahub.dev/v1";
const headers = { "Authorization": "Bearer em_your_api_key_here" };

// 列出 Kit
const list = await fetch(`${BASE}/prompts?persona=frontend-indie-dev&limit=20`, { headers })
  .then(r => r.json());

// 获取完整 Kit（含 prompts 步骤）
const kit = await fetch(`${BASE}/prompts/${list.data[0].id}`, { headers })
  .then(r => r.json());

// 把 kit.prompts 塞进你的 AI Agent
for (const step of kit.prompts) {
  console.log(`Step ${step.step} [${step.role}]: ${step.content}`);
}

Authorization: Bearer em_xxxxxxxxxxxxxxxxxxxxxxxx

{
  "id": "kit_frontend-indie-dev_ssr-hydration-mismatch_001",
  "persona": "frontend-indie-dev",
  "workflow_id": "ssr-hydration-mismatch",
  "title": "SSR 水合报错完整处理套装",
  "description": "覆盖 Next.js App Router 水合错误的完整排查链路",
  "scenario": "Hydration failed / Text content does not match server-rendered HTML",
  "tier": "free",
  "estimated_time_save": "≈ 2h",
  "vs_naive": "朴素问法只说「检查差异」，本套装按 7 类报错逐类给修复代码",
  "pro_tip": "先跑 Step1 分类，90% 情况 Step1+Step3 就够了",
  "tags": ["Next.js", "hydration", "SSR", "debug"],
  "model_target": ["claude", "gpt-4o"],
  "quality_score": 8.7,
  "prompts": [
    {
      "step": 1,
      "role": "诊断",
      "title": "错误分类与根因定位",
      "content": "你是一位 Next.js 专家……{完整 prompt 正文}",
      "variables": [
        {
          "name": "{错误信息}",
          "description": "浏览器控制台的完整报错",
          "example": "Hydration failed because..."
        }
      ],
      "usage_example": "…"
    },
    { "step": 2, "role": "复现", "title": "…", "content": "…" },
    { "step": 3, "role": "修复", "title": "…", "content": "…" },
    { "step": 4, "role": "验证", "title": "…", "content": "…" }
  ]
}

{
  "query": "MCP配置",
  "kits": {
    "data": [ /* ...Workflow Kit 摘要... */ ],
    "total": 0
  },
  "docs": {
    "data": [
      {
        "id": "doc_cline_cli-v3.0.13",
        "tool": "cline",
        "version": "cli-v3.0.13",
        "version_safe": "cli-v3.0.13",
        "title": "Cline CLI 文档",
        "license": "Apache-2.0",
        "tier": "free",
        "tags": ["cline", "CLI工具", "AI编程", "MCP"],
        "persona_tags": ["frontend-indie-dev", "backend-dev"],
        "stars": 62515,
        "translated_at": "2026-05-30"
      }
    ],
    "total": 3
  },
  "match_status": "exact",
  "fallback": null,
  "page": 1,
  "limit": 20
}

curl "https://api.emirahub.dev/api/v1/search?q=MCP+配置" \
  -H "Authorization: Bearer em_your_api_key_here"

{
  "data": [
    {
      "id": "kit_frontend-indie-dev_ssr-hydration-mismatch_001",
      "persona": "frontend-indie-dev",
      "workflow_id": "ssr-hydration-mismatch",
      "title": "SSR 水合报错完整处理套装",
      "description": "…",
      "scenario": "…",
      "tier": "free",
      "estimated_time_save": "≈ 2h",
      "vs_naive": "…",
      "pro_tip": "…",
      "tags": ["Next.js", "hydration", "SSR", "debug"],
      "model_target": ["claude", "gpt-4o"],
      "quality_score": 8.7,
      "version": "1.0",
      "created_at": "2026-05-20"
    }
  ],
  "total": 2525,
  "page": 1,
  "limit": 20
}

curl "https://api.emirahub.dev/api/v1/prompts/kit_frontend-indie-dev_ssr-hydration-mismatch_001" \
  -H "Authorization: Bearer em_your_api_key_here"

{
  "data": [],
  "total": 0,
  "page": 1,
  "limit": 20,
  "match_status": "none",
  "fallback": {
    "related_kits": [],
    "universal_diagnose_kit": {
      "id": "kit_frontend-indie-dev_universal-diagnose_001",
      "title": "Frontend独立开发者问题万能诊断器",
      "prompts": [{ "step": 1, "content": "...{{user_question}}..." }]
    },
    "one_shot_questions": [
      "你用的是哪个框架/版本（React / Next.js 几？）",
      "是本地复现还是只在生产出现？",
      "最近有没有改动依赖或配置文件？"
    ]
  },
  "request_recorded": true
}

{
  "data": [
    {
      "id": "doc_fastapi_0.136.3",
      "tool": "fastapi",
      "version": "0.136.3",
      "version_safe": "0.136.3",
      "title": "FastAPI 官方文档 (中文版)",
      "source_url": "https://github.com/fastapi/fastapi",
      "license": "MIT",
      "license_type": "full_translate",
      "lang": "zh",
      "tier": "free",
      "tags": ["fastapi", "python", "API框架", "REST", "后端开发"],
      "persona_tags": ["backend-dev", "ai-engineer"],
      "stars": 98640,
      "summary": "高性能Python Web框架，类型注解驱动自动生成API文档。A high-performance Python web framework with auto-generated API docs driven by type hints.",
      "source_date": "2026-05-28",
      "translated_at": "2026-05-30",
      "freshness_note": "内容基于 2026-05-28 版本，以官方 GitHub 为准"
    }
  ],
  "total": 10,
  "page": 1,
  "limit": 20
}

# 获取 Cursor 最新版文档
curl "https://api.emirahub.dev/api/v1/docs/cursor/latest" \
  -H "Authorization: Bearer em_your_api_key_here"

# 获取 Cline 指定版本
curl "https://api.emirahub.dev/api/v1/docs/cline/cli-v3.0.13" \
  -H "Authorization: Bearer em_your_api_key_here"

curl -X POST "https://api.emirahub.dev/api/v1/feedback" \
  -H "Authorization: Bearer em_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mcp server",
    "intent_summary": "用户要做 MCP Server 集成 Claude Desktop",
    "kit_id": null,
    "result_count": 0,
    "helpful": false,
    "missing_content": "缺少 MCP Server 开发 Kit"
  }'
# → { "status": "ok" }

// → POST body
{ "package_id": "starter", "currency": "cny" }

// ← response
{ "url": "https://checkout.stripe.com/c/pay/..." }

// 401 — Key 无效
{ "detail": "Could not validate credentials" }

// 429 — 额度用尽，需充值
{ "detail": {
    "code": "quota_exceeded",
    "message": "Monthly free quota exhausted. Please top up to continue.",
    "top_up_url": "https://emirahub.dev/dashboard#billing"
} }

# Python SDK
pip install "git+https://github.com/Rayhonglin/emirahub-sdk.git#subdirectory=python"

# MCP Server
pip install "git+https://github.com/Rayhonglin/emirahub-sdk.git#subdirectory=mcp"

# JavaScript / TypeScript SDK
git clone https://github.com/Rayhonglin/emirahub-sdk.git && cd emirahub-sdk/js && npm install