monologue-notes-api

Monologue Notes API

このスキルでは、Monologue Notes REST API を直接呼び出すために必要な情報を提供します。 認証済みユーザーのノートに対する読み取り専用操作に使用します。

タスクに適した任意の HTTP クライアントを使用してください。curl、短いスクリプト、その他の REST 対応ツールなどが利用できます。 ユーザーから求められない限り、クライアントライブラリをでっち上げないでください。

Authentication

環境変数 MONOLOGUE_API_KEY をベアラートークンとして使用します。

• 必須の認証ヘッダー：Authorization: Bearer $MONOLOGUE_API_KEY
• 必須スコープ：notes:read
• トークンを表示、エコー、ログ出力したり、ユーザーへの応答に含めたりしないでください
• シェル変数の展開を使用し、Authorization ヘッダーにのみ渡してください

トークンを表示せずに、利用可能かどうかを確認します。

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

Base URL

• ベース URL：https://api.monologue.to
• API 形式：読み取り専用 Notes API
• データ形式：JSON
• タイムスタンプ：ISO 8601 日時文字列

Request Pattern

すべてのリクエストで、次の形式を使用してください。

curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/..."

構造化された出力が有用な場合は、レスポンスを jq にパイプしてください。

Endpoints

ノートの一覧表示

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}

認証済みユーザーに属する 1 件のノートの詳細を返します。

パスパラメーター：

• 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：検証エラー

Common Workflows

キーワードでノートを検索する

q パラメーターを使用します。

curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?q=meeting"

検索対象：

• ノートのタイトル
• ノートの要約
• ノートの文字起こし

結果をページ単位で取得する

1. GET /v1/public-api/notes を呼び出します
2. レスポンスから next_cursor を読み取ります
3. そのカーソルを cursor クエリパラメーターとして渡します
4. 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"

Operating Rules

• この API は読み取り専用として扱ってください
• 書き込みに対応していると主張しないでください。このスキルの対象はノートの一覧表示と読み取りのみです
• リクエストには https://api.monologue.to を優先して使用してください
• 失敗を報告する際は、トークンを漏らさず、HTTP ステータスと関連するレスポンス本文を要約してください
• ユーザーがローカルでの後処理を必要とするワークフローを求めた場合は、最初にデータを取得し、その後で別途変換してください

Source Notes

このスキルは、次の情報に基づいています。

• /Users/eleanor/repos/obsidian/intellectronica/2026-04-21-20-10 Monologue API.md
• 2026-04-22 に https://api.monologue.to/public-openapi.json を対象に実施したライブ OpenAPI チェック