Monologue Notes API 技能提供直接调用 Monologue Notes REST API 所需的信息，用于对已认证用户的笔记执行只读操作。
用途 该技能适用于用户希望通过 Monologue Notes REST API 读取或搜索其 Monologue 笔记的场景。它仅覆盖列出和读取笔记，不涉及写入操作。
认证 使用环境变量 MONOLOGUE_API_KEY 作为 Bearer 令牌。 所需认证头：Authorization: Bearer $MONOLOGUE_API_KEY 所需权限范围：notes:read 切勿打印、回显、记录令牌，也不要将其包含在给用户的回复中。只能通过 Authorization 头以 shell 变量展开的方式传递。 可在不显示令牌的情况下检查其是否可用： if [ -z "${MONOLOGUE_API_KEY:-}" ]; then echo "MONOLOGUE_API_KEY is not set" fi 如果 MONOLOGUE_API_KEY 缺失：报告该环境变量不存在；询问用户是否愿意提供 API 密钥；在令牌可用之前不要尝试进行已认证的 API 调用。 应避免以下命令，因为它们会暴露密钥： echo "$MONOLOGUE_API_KEY" env | grep MONOLOGUE_API_KEY set | grep MONOLOGUE_API_KEY
基础信息 基础 URL：https://api.monologue.to API 形态：只读 Notes API 数据格式：JSON 时间戳：ISO 8601 日期时间字符串
请求模式
所有请求：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/..."
如需结构化输出，可将响应通过管道传给 jq。
端点
列出笔记
GET /v1/public-api/notes
返回已认证用户的一页笔记。
支持的查询参数：
limit：1 到 100 的整数，默认 20
cursor：来自先前响应的不透明分页游标
created_after：ISO 8601 时间戳
created_before：ISO 8601 时间戳
updated_after：ISO 8601 时间戳
q：跨标题、摘要和转录文本的全文搜索
示例：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes?limit=20&q=interview"
配合 jq 的示例：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes?limit=20"
| jq '{next_cursor, items: [.items[] | {note_id, title, summary, created_at, updated_at}]}'
预期响应字段：
items：笔记摘要数组
next_cursor：下一页的游标（如有）
每个列表项可能包含：
note_id
title
summary
created_at
updated_at
可能的错误：
400：无效的过滤条件或游标
401：令牌缺失或无效
403：令牌缺少所需权限范围
422：验证错误
获取单条笔记
GET /v1/public-api/notes/{note_id}
返回属于已认证用户的一条笔记的完整详情。
路径参数：
note_id：由列表端点返回的笔记标识符
示例：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes/NOTE_ID"
配合 jq 的示例：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes/NOTE_ID"
| jq '{note_id, title, summary, transcript, transcript_segments, created_at, updated_at}'
除列表字段外，完整笔记响应还可能包含：
transcript
transcript_segments
说明：
transcript_segments 是松散类型的结构化 JSON，可能为 null
404 表示未找到属于已认证用户的该笔记
可能的错误：
401：令牌缺失或无效
403：令牌缺少所需权限范围
404：笔记未找到
422：验证错误
常见工作流
按关键词搜索笔记
使用 q 参数：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes?q=meeting"
搜索覆盖：
笔记标题
笔记摘要
笔记转录文本
分页浏览结果
调用 GET /v1/public-api/notes
从响应中读取 next_cursor
将该游标作为 cursor 查询参数传回
当 next_cursor 缺失或为 null 时停止
示例：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes?limit=50&cursor=OPAQUE_CURSOR"
按时间过滤
使用 ISO 8601 日期时间值：
curl -sS
-H "Authorization: Bearer $MONOLOGUE_API_KEY"
"https://api.monologue.to/v1/public-api/notes?created_after=2026-01-01T00:00:00Z"
操作规则 将此 API 视为只读 不要声称支持写入；该技能仅覆盖列出和读取笔记 请求时优先使用 https://api.monologue.to 报告失败时，概述 HTTP 状态和相关响应体，但不要暴露令牌 如果用户要求的工作流需要本地后处理，先获取数据，再单独进行转换
来源说明 该技能基于： /Users/eleanor/repos/obsidian/intellectronica/2026-04-21-20-10 Monologue API.md 2026-04-22 针对 https://api.monologue.to/public-openapi.json 的实时 OpenAPI 检查