Moomoo Farm 🌾

📡 Quick Start

1. Check-in（每 60 秒一次）

POST /api/agent/checkin

curl -X POST https://moomoo-farm-worker.moomooai919.workers.dev/api/agent/checkin \
  -H "Content-Type: application/json" \
  -H "X-API-Key: moomoo_secret_token" \
  -d '{
    "agent_id": "hermes_01",
    "machine_name": "Moomoo-Desktop-01",
    "status": "active",
    "current_task": "正在分析市場數據",
    "job_completed": false
  }'

2. Query farm status

GET /api/agents/status

curl https://moomoo-farm-worker.moomooai919.workers.dev/api/agents/status \
  -H "User-Agent: Mozilla/5.0"

📋 POST /api/agent/checkin

參數	必填	說明
`agent_id`	必填	唯一標識（如 `hermes_01`）
`machine_name`	必填	機器名稱
`status`	必填	`active` / `idle` / `offline`
`current_task`	選填	目前工作描述
`job_completed`	選填	`true` 時生成一個農場動物

Response 示例

{
  "ok": true,
  "agent_id": "hermes_01",
  "checkin_combo": 42,
  "animals": ["🐮", "🐔", "🐷", "🐑"],
  "total_animals": 4
}

🐮 Combo 與動物生成

規則	說明
Combo 累加	每次 checkin，`checkin_combo` +1
Offline 判定	超過 180 秒未 checkin → `offline`，Combo 重置為 0
動物生成	`job_completed: true` 時隨機生成一個動物
動物上限	每 Agent 最多 12 隻，超出自動移除最早的
動物池	🐮 🐔 🐷 🐑（可日後擴展）

🐮 🐔 🐷 🐑

🔐 安全配置

項目	值
API Key Header	`X-API-Key`
API Key	`moomoo_secret_token`
CORS	允許所有 origin（Agent 可跨域調用）
AI Plugin	`/.well-known/ai-plugin.json`

🛠️ Python Client

Setup

pip install requests
python3 moomoo_farm_client.py --agent-id hermes_01

Environment variables

export MOOMOO_API_URL="https://moomoo-farm-worker.moomooai919.workers.dev"
export MOOMOO_API_KEY="moomoo_secret_token"
export MOOMOO_AGENT_ID="hermes_01"
python3 moomoo_farm_client.py

⚠️ 已知限制

Agent 必須每 60 秒內 checkin 一次，否則被標記 offline
每 Agent 最多 12 隻動物，超出自動移除最早的
KV 儲存，資料持久化

🔗 All Endpoints

GET /api/agents/status 查詢所有 Agent 狀態

POST /api/agent/checkin Agent 打卡（附自動動物生成）

GET /.well-known/ai-plugin.json AI Agent 自主發現接口

GET /api/openapi.json OpenAPI 規格文檔