Looper — 持续改进引擎

Looper 运行自动化循环任务，按计划分析、生成并优化您的内容与代码。

• 服务地址: https://looper.bot
• API 地址: https://api.looper.bot
• 引擎类型: Analyze（代码审查）、Create（内容生成）、Blog Kit（每日博客）、Social Kit（社交媒体发布）

快速开始

1. 注册账号

curl -X POST https://api.looper.bot/api/signup 
  -H "Content-Type: application/json" 
  -d '{"email": "you@example.com", "password": "your-password"}'

响应中包含 admin_key（以 lp_ 开头）。请务必保存 — 该密钥仅显示一次。

2. 登录（如后续需获取租户信息）

curl -X POST https://api.looper.bot/api/login 
  -H "Content-Type: application/json" 
  -d '{"email": "you@example.com", "password": "your-password"}'

3. 创建一个 Loop

所有 API 调用均需携带请求头 Authorization: Bearer 。

Blog Kit（每日博客发布）

按计划为您自动生成博客文章，并提交至 GitHub 仓库。

curl -X POST https://api.looper.bot/api/loops 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{
    "name": "My Blog",
    "target_type": "github",
    "target_config": {
      "owner": "",
      "repo": "",
      "branch": "main",
      "path": "blog"
    },
    "template_id": "68b7e661-46e1-45cd-b25a-584b8cd392b1",
    "schedule": "0 6 * * *",
    "schedule_tz": "America/New_York",
    "mode": "auto",
    "model": "gpt-4o-mini",
    "questions": ["Write a blog post about . Research current events. 400-600 words. NO em dashes. Include YAML frontmatter with slug, title, excerpt, date, readTime, tag."]
  }'

关键字段说明：

• target_config.path —— 仓库中存放 Markdown 博客文章的目录路径
• schedule —— Cron 表达式（例如 0 6 * * * 表示每天上午 6 点执行）
• schedule_tz —— 执行计划所采用的时区
• mode —— 执行模式：auto（直接提交）、propose（创建 PR）、notify（仅发送通知）
• questions[0] —— 驱动内容生成的提示词（Prompt）

Blog Kit 模板 ID：68b7e661-46e1-45cd-b25a-584b8cd392b1

Analyze（代码改进）

扫描您的代码库，提出或自动应用改进建议。

curl -X POST https://api.looper.bot/api/loops 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{
    "name": "Code Review",
    "target_type": "github",
    "target_config": {
      "owner": "",
      "repo": "",
      "branch": "main"
    },
    "schedule": "0 2 * * 1",
    "mode": "propose",
    "questions": [
      "Are there any security vulnerabilities?",
      "Is error handling consistent?",
      "Are there performance bottlenecks?"
    ]
  }'

Social Kit（多平台社交发布）

通过 Upload-Post 集成方式生成并发布社交媒体内容。

Social Kit 模板 ID：7431b897-396f-4542-8e32-d8d1c5e445a2

curl -X POST https://api.looper.bot/api/loops 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{
    "name": "Social Posts",
    "target_type": "text",
    "target_config": {},
    "template_id": "7431b897-396f-4542-8e32-d8d1c5e445a2",
    "schedule": "0 9 * * 1,3,5",
    "mode": "auto",
    "questions": ["{"upload_post_profile": "my-profile", "upload_post_api_key": "", "platforms": ["x", "linkedin"], "business_name": "My Business", "industry": "tech"}"]
  }'

Loop 管理

列出全部 Loop

curl -s https://api.looper.bot/api/loops 
  -H "Authorization: Bearer "

查看指定 Loop 详情

curl -s https://api.looper.bot/api/loops/ 
  -H "Authorization: Bearer "

查看运行历史记录

curl -s https://api.looper.bot/api/loops//runs 
  -H "Authorization: Bearer "

启用或禁用 Loop

curl -X PATCH https://api.looper.bot/api/loops/ 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{"enabled": false}'

手动触发一次运行

curl -X POST https://api.looper.bot/api/loops//run 
  -H "Authorization: Bearer "

更新 Loop 配置

curl -X PATCH https://api.looper.bot/api/loops/ 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{"schedule": "0 8 * * *", "model": "gpt-4o"}'

删除 Loop

curl -X DELETE https://api.looper.bot/api/loops/ 
  -H "Authorization: Bearer "

订阅方案

通过 Stripe 升级：向 POST /api/stripe/checkout 发送请求体 {"plan": "pro"}。

GitHub 接入

如需将 Loop 关联至特定 GitHub 仓库，请完成以下接入流程：

# 获取 OAuth 授权 URL
curl -s https://api.looper.bot/api/github/connect 
  -H "Authorization: Bearer "

# 访问返回的 URL 完成授权，之后检查接入状态：
curl -s https://api.looper.bot/api/github/status 
  -H "Authorization: Bearer "

API 密钥管理

# 列出密钥（仅返回元数据，不暴露密钥本身）
curl -s https://api.looper.bot/api/keys 
  -H "Authorization: Bearer "

# 创建新密钥
curl -X POST https://api.looper.bot/api/keys 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{"name": "CI Key"}'

Agent 接入流程

当 Agent 需要自动化内容生成或代码改进能力时，可按以下步骤集成 Looper：

1. 检查 Agent 是否已拥有 Looper 账号（查看环境变量中是否存在 LOOPER_ADMIN_KEY）
2. 若不存在，则调用 API 注册账号，并妥善保存返回的 admin_key
3. 如目标为 GitHub 仓库，需先完成 GitHub 接入
4. 使用对应模板与调度策略创建 Loop
5. 验证首次运行是否成功

此后，Agent 可完全通过 API 管理 Loop，无需浏览器交互。