notion-api(curl を使用して Notion REST API を直接呼び出す)

個人開発者 intellectronica による Notion スキル:MCP を経由せず、エージェントが curl と jq を使用して Notion REST API を直接呼び出し、コンテンツの検索、ページおよびブロックの読み取り・書き込み、データベースとデータソースのクエリ・作成、コメントの読み取り・書き込みを行います。SKILL.md には各エンドポイントのリクエスト例が記載されています。

個人開発者 intellectronica による Notion スキル:MCP を経由せず、エージェントが curl と jq を使用して Notion REST API を直接呼び出し、コンテンツの検索、ページおよびブロックの読み取り・書き込み、データベースとデータソースのクエリ・作成、コメントの読み取り・書き込みを行います。SKILL.md には各エンドポイントのリクエスト例が記載されています。

skills.sh インストール数 98110(+518 / 24時間)

セキュリティ監査:未監査

  • まだスキャンされていません

理由

  • 認証情報の処理が明確です:まず環境変数 NOTION_API_TOKEN を探査し、次にユーザーが会話内で提供したものを使用し、どちらも存在しない場合はユーザーに尋ねます。トークンは Authorization リクエストヘッダーにのみ含め、表示やログへの書き込みを行わないことが要求されています。
  • 変更前の確認:ページの更新やブロックの変更、アーカイブ・削除、データベース構造の変更、ページの一括作成を行う前に、ユーザーに確認を求めます。関連する一連の操作については一度だけ確認します。
  • Notion-Version 2025-09-03 に準拠して作成されており、新しいデータソース(data source)インターフェースをサポートしています。ページネーションの実装方法、429 レート制限バックオフ、リクエストサイズ上限に関する情報が含まれています。
  • リポジトリは CC0 ライセンスです。skills.sh では 24 時間で 518 回インストールされ、累計で 98110 回インストールされています。直近 8 週間の週次インストール数は 2335 から 5232 に増加しています(これは注目度を示すに過ぎません)。

使い方

  • インストールコマンドは監査合格後に表示されます。エージェントに「Notion ページの読み取り/変更」や「Notion データベースのクエリ」を依頼した際にトリガーされます。
  • Notion 統合用の API トークン(環境変数 NOTION_API_TOKEN に設定)が必要です。ローカルマシンには curl と jq が必要です。

リスク

  • 本バージョンは未監査であり、固定の C 評価です。インストールコマンドは表示されません。SKILL.md では、エージェントが curl を実行して api.notion.com にアクセスし、NOTION_API_TOKEN を読み取ることが許可されていますが、これは用途と一致しています。skills.sh 上の Gen Agent Trust Hub による監査結果は Pass です。
  • Notion 公式の製品ではありません。トークンを会話内に貼り付けると会話履歴に残るため、環境変数を使用する方が安全です。
  • エージェントにはページのアーカイブやブロックの削除機能があります。事前確認はエージェントの遵守に依存します。Notion API のバージョンが更新されると、例示コードが古くなる可能性があります。

開く · リポジトリ

Best Skills 每日数据(LinklyAI / @BlueeonY,CC BY 4.0)

最新の AI ニュースを見る