用途:通过 Metaculus API 与预测平台交互,浏览帖子、查看问题与社区预测、提交或撤回预测、读写评论、下载数据。
主要能力:GET /api/posts/ 分页检索帖子,支持按锦标赛、状态、类型、分类、预测者等过滤与排序;GET /api/posts/{postId}/ 获取单个帖子详情;POST /api/questions/forecast/ 提交二元、多选、连续(数值/日期/离散)及条件预测;POST /api/questions/withdraw/ 撤回预测;GET /api/comments/ 与 POST /api/comments/create/ 处理评论;GET /api/posts/{postId}/download-data/ 和 GET /api/projects/{projectId}/download-data/ 下载 CSV 压缩包。
使用方式:所有请求基于 https://www.metaculus.com,需在请求头加入 Authorization: Token <token>。Token 从账户设置 API Access 获取,建议存入环境变量 METACULUS_API_TOKEN。提交预测时 question 字段须填问题 ID 而非帖子 ID;二元预测用 probability_yes,多选用 probability_yes_per_category(概率和为 1),连续预测用 continuous_cdf(201 个浮点数)。
限制:所有请求均需认证;平台有速率限制,遇 429 应指数退避重试;项目数据下载需管理员或白名单权限;部分字段如描述需 include_descriptions=true 才返回。具体收费、价格与平台支持范围暂未提供。