开发者

基于 WeeklyPlanner 构建

你可以通过公开 API 访问任务、分组、偏好设置、用户资料和自动化能力。MCP Server 也复用同一套接口边界。

创建账号登录 /settings

REST API

当前已经提供 /api/v1 下的任务、分组、资料、设置、统计和 API Key 等接口。

API Key 与 Scope

你可以在设置页生成 API Key，并且只给它分配当前集成真正需要的权限范围。

MCP Server

仓库里已经有独立的 MCP Server，现在也已经接到同一套任务和设置 API 上。

安全边界

应用登录仍然由 Supabase Auth 负责，API Key 校验、权限范围和限流也已经收敛到统一入口。

快速开始

1. 先创建账号

先注册并登录，然后到设置页管理开发者访问能力。

2. 创建 API Key

在设置页生成 API Key，只勾选当前真正需要的 scope，并马上保存。明文 key 只会显示一次。

3. 调用 API 或 MCP

把 API Key 放到 Bearer Token 里。MCP 请求还会额外带上 X-WeeklyPlanner-Source: mcp。

调用示例

读取任务

curl -X GET "https://weeklyplanner.cc/api/v1/tasks?date_from=2026-03-01&date_to=2026-03-31" \
  -H "Authorization: Bearer wp_your_api_key" \
  -H "Content-Type: application/json"

创建任务

curl -X POST "https://weeklyplanner.cc/api/v1/tasks" \
  -H "Authorization: Bearer wp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Prepare weekly review",
    "date": "2026-03-20",
    "time_block": "evening",
    "priority": "high"
  }'

MCP 环境变量

WEEKLYPLANNER_API_URL=https://weeklyplanner.cc
WEEKLYPLANNER_API_KEY=wp_your_api_key

当前可用的 Scope

每个集成尽量只给最小权限集，避免把写权限放给不需要写入的工具。

tasks:readtasks:writegroups:readgroups:writestats:readsettings:readsettings:writeprofile:readprofile:write

核心接口

任务

支持任务列表、创建、更新、删除、批量更新和拖拽后的重排。

分组

支持分组名称、颜色、顺序管理，以及跨分组移动任务。

设置与资料

支持读取和更新视图偏好、语言、ADHD 模式和个人资料字段。

统计

支持读取聚合后的使用情况和计划统计，方便仪表盘或 AI 工作流使用。

接口说明和示例会继续补充。产品内的支付与结账已经接入 Creem，但公共开发者接口暂时仍聚焦任务、设置、统计和 API Key，不开放账单管理接口。