名称： voicenotes
描述： 同步并访问来自 Voicenotes.com 的语音笔记。当用户需要从 Voicenotes 获取其录音、转录文本和 AI 摘要时使用。支持获取笔记、同步至 Markdown 以及搜索转录文本。

Voicenotes 集成

将语音笔记从 voicenotes.com 同步至工作区。

设置

1. 获取访问令牌：https://voicenotes.com/app?obsidian=true#settings
2. 设置环境变量：export VOICENOTES_TOKEN="你的令牌"

快速开始

# 验证连接
./scripts/get-user.sh | jq .

# 获取最近的笔记（JSON格式）
./scripts/fetch-notes.sh | jq '.data[:3]'

# 将所有笔记同步为 Markdown 文件
./scripts/sync-to-markdown.sh --output-dir ./voicenotes

脚本说明

fetch-notes.sh

以 JSON 格式获取语音笔记。

./scripts/fetch-notes.sh                    # 所有笔记
./scripts/fetch-notes.sh --limit 10         # 最近 10 条笔记
./scripts/fetch-notes.sh --since 2024-01-01 # 指定日期之后的笔记

get-user.sh

验证令牌并获取用户信息。

./scripts/get-user.sh | jq '{name, email}'

sync-to-markdown.sh

将笔记同步为包含 Frontmatter 的 Markdown 文件。

./scripts/sync-to-markdown.sh --output-dir ./voicenotes

输出格式：

---
voicenotes_id: abc123
created: 2024-01-15T10:30:00Z
**标签：** [idea, project]
---

# 笔记标题

## 转录文本
这里是转录的内容...

## 摘要
这里是 AI 生成的摘要...

API 参考

基础 URL：https://api.voicenotes.com/api/integrations/obsidian-sync

必需请求头：
- Authorization: Bearer {token}
- X-API-KEY: {token}

端点：
- GET /user/info - 用户详情
- GET /recordings - 列出语音笔记（分页）
- GET /recordings/{id}/signed-url - 音频下载 URL

数据结构

每条语音笔记包含：
- recording_id - 唯一标识符
- title - 笔记标题
- transcript - 完整转录文本
- creations[] - AI 摘要、待办事项等
- tags[] - 用户标签
- created_at / updated_at - 时间戳
- duration - 录音时长（秒）

使用提示

• 笔记采用分页机制；检查 links.next 可获取更多页面。
• 使用 --since 参数仅同步上次同步之后的新笔记。
• AI 生成内容包含摘要、待办事项和自定义提示。
• 速率限制约为每分钟 60 次请求。