360 Secure SkillHub
360 安全技能中心

Voicenotes

通过 Voicenotes.com 的 obsidian-sync API 拉取用户的语音笔记、转写文本、AI creations 与标签，支持按数量或时间过滤、校验令牌，并将笔记同步为带 frontmatter 的 Markdown 文件；依赖 VOICENOTES_TOKEN 环境变量、curl 与 jq。

shawnhansen
shawnhansen
热度 89.39
最近更新 2026-05-18 17:27:58
分类：知识依赖：代码执行 / 读写文件 / 第三方 API应用场景：笔记整理 / API 集成 / 文件转换 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add voicenotes
Metadata
name
voicenotes
description
Sync and access voice notes from Voicenotes.com. Use when the user wants to retrieve their voice recordings, transcripts, and AI summaries from Voicenotes. Supports fetching notes, syncing to markdown, and searching transcripts.

Voicenotes Integration

Sync voice notes from voicenotes.com into the workspace.

Setup

  1. Get access token from: https://voicenotes.com/app?obsidian=true#settings
  2. Set environment variable: export VOICENOTES_TOKEN="your-token-here"

Quick Start

# Verify connection
./scripts/get-user.sh | jq .

# Fetch recent notes (JSON)
./scripts/fetch-notes.sh | jq '.data[:3]'

# Sync all notes to markdown files
./scripts/sync-to-markdown.sh --output-dir ./voicenotes

Scripts

fetch-notes.sh

Fetch voice notes as JSON.

./scripts/fetch-notes.sh                    # All notes
./scripts/fetch-notes.sh --limit 10         # Last 10 notes
./scripts/fetch-notes.sh --since 2024-01-01 # Notes since date

get-user.sh

Verify token and get user info.

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

sync-to-markdown.sh

Sync notes to markdown files with frontmatter.

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

Output format:

---
voicenotes_id: abc123
created: 2024-01-15T10:30:00Z
tags: [idea, project]
---

# Note Title

## Transcript
The transcribed content...

## Summary
AI-generated summary...

API Reference

Base URL: https://api.voicenotes.com/api/integrations/obsidian-sync

Headers required:

  • Authorization: Bearer {token}
  • X-API-KEY: {token}

Endpoints:

  • GET /user/info - User details
  • GET /recordings - List voice notes (paginated)
  • GET /recordings/{id}/signed-url - Audio download URL

Data Structure

Each voice note contains:

  • recording_id - Unique identifier
  • title - Note title
  • transcript - Full transcript text
  • creations[] - AI summaries, action items, etc.
  • tags[] - User tags
  • created_at / updated_at - Timestamps
  • duration - Recording length in seconds

Tips

  • Notes are paginated; check links.next for more pages
  • Use --since to fetch only new notes since last sync
  • AI creations include summaries, todos, and custom prompts
  • Rate limited to ~60 requests/minute