turso-cloud について
Turso Cloud を利用する開発者向けのドキュメントスキルです。複数言語の SDK、認証、Vercel でのデータベース管理に加え、データベース機能を扱います。
主な機能
- 01JavaScript、Python、Go、Rust の SDK ガイド
- 02リモートおよびローカルファーストのデータベースアクセス
- 03認証情報のスコープとテーブル権限
- 04Vercel Marketplace のデータベース管理
- 05ベクトル検索、全文検索、ブランチ作成
活用シーン
- 01アプリケーションから Turso Cloud データベースへ接続
- 02ローカルファーストまたはリモート専用アクセスの選択
- 03データベース認証情報と権限の制限
- 04Vercel プロジェクト用 Turso データベースの構築
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ tursodatabase/ agent-skills --skill turso-cloudインストール後、Claude Code で/turso-cloudを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
turso-cloud-auth/overview.mdturso-cloud-go/overview.mdturso-cloud-js/overview.mdturso-cloud-py/overview.mdturso-cloud-rust/overview.mdturso-cloud-vercel/overview.md詳細
Turso Cloud スキル
このスキルは、完全マネージドの SQLite 互換データベースプラットフォームである Turso Cloud を扱うためのドキュメントをまとめたものです。以下から該当するサブスキルを選んでください。
turso-cloud-js
リモートの Turso Cloud データベース向けの @tursodatabase/serverless TypeScript/JavaScript SDK を扱います — クエリ、位置指定/名前付きパラメーター、バッチ、対話型トランザクション — に加えて、ローカルファーストの同期ファミリー(@tursodatabase/sync、-wasm、-react-native)も扱います。Node.js、サーバーレス/エッジ関数、ブラウザー、React Native から Turso Cloud に接続する場合に使用します。
turso-cloud-py
Python から Turso Cloud を扱います。クラウドと同期するローカルファーストデータベースには pyturso、libsql プロトコル経由のリモート専用アクセスには libsql を使用します。Python アプリケーションを Turso Cloud に接続する場合に使用します。
turso-cloud-go
Go から Turso Cloud を扱います。クラウドと同期するローカルファーストデータベースには tursogo、libsql プロトコル経由のリモート専用アクセスには libsql-client-go を使用します。Go アプリケーションを Turso Cloud に接続する場合に使用します。
turso-cloud-rust
Rust から Turso Cloud を扱います。クラウドと同期するローカルファーストデータベースには turso クレート(sync フィーチャー)、libsql プロトコル経由のリモート専用アクセスには libsql クレートを使用します。Rust アプリケーションを Turso Cloud に接続する場合に使用します。
turso-cloud-auth
Turso Cloud データベースへのアクセスの認証と認可を行います。データベース URL、Turso CLI によるプラットフォームトークン、スコープ設定(グループ/データベース/読み取り専用/期間限定)、テーブル単位のきめ細かな権限、JWKS による外部認証プロバイダー(Clerk、Auth0)、トークンの無効化などを扱います。認証情報を発行する場合、クライアントが実行できる操作を制限する場合、または既存の認証プロバイダーを Turso に接続する場合に使用します。
turso-cloud-vercel
Vercel Marketplace(インテグレーションスラッグ tursocloud)を通じてプロビジョニングされた Turso Cloud データベースを使用および管理します。注入される環境変数、Vercel CLI によるリソースの検査とプロビジョニング、リージョンの選択、認証情報と破壊的操作に関する安全ルールなどを扱います。Vercel プロジェクトに Turso データベースがある場合、または必要な場合に使用します。
Turso Cloud の機能
Turso Cloud データベースは、これらの機能をすぐに利用できます:
- ベクトル検索 — AI/RAG ワークフロー向けのネイティブな類似検索で、拡張機能は不要です。DiskANN インデックスによるコサイン距離、L2 距離、L1 距離関数をサポートします。
- 全文検索 — 組み込みの FTS サポートによる BM25 ランキングでのキーワード検索。
- AI と埋め込み — 埋め込みを保存およびクエリするためのネイティブなベクトル型。
- ブランチング — テスト/ステージング用に分離されたコピーオンライトのデータベースブランチを作成できます。
- ポイントインタイムリカバリ — データベースを任意の過去の時点に復元できます(保持期間はプランによって異なります)。
- 埋め込みレプリカ — Turso Cloud と同期するローカルレプリカにより、高速な読み取りとオフラインサポートを実現します。
- SQLite 拡張機能 — JSON、FTS5、R*Tree、SQLean、UUID、regexp。
参考資料
Turso オンラインドキュメント — https://docs.turso.tech(Mintlify — 任意の URL パスの末尾に .md を付けると生の markdown を取得できます。例: https://docs.turso.tech/sdk/ts/quickstart.md)。各サブスキルにはそれぞれのドキュメントリンクがあります。一般的な参照先:
| トピック | URL |
|---|---|
| AI と埋め込み | https://docs.turso.tech/features/ai-and-embeddings.md |
| 埋め込みレプリカ | https://docs.turso.tech/features/embedded-replicas/introduction.md |
| クラウドの制限事項 | https://docs.turso.tech/cloud/limitations.md |
| SQLite 拡張機能 | https://docs.turso.tech/features/sqlite-extensions.md |
| ドキュメント全体のインデックス(LLM 向け) | https://docs.turso.tech/llms.txt |