> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notcms.com/llms.txt
> Use this file to discover all available pages before exploring further.
# はじめに
> NotionワークスペースをタイプセーフなヘッドレスCMSに変換
## NotCMSとは？
NotCMSは、Notionをコンテンツバックエンドとして使用するヘッドレスCMSです。コンテンツ作成者にはNotionの直感的なエディタを、開発者にはタイプセーフなAPIを提供し、両者にとって最高の体験を実現します。
スキーマからクエリまでエンドツーエンドの型安全性と優れた開発者体験。完全なTypeScriptサポートによりランタイムエラーを防ぎます。
チームが既に知っているNotionエディタを使用。新しいCMSインターフェースを学ぶ必要はなく、初日から生産的に作業できます。
CLIツールを使用して数分で開始。複雑な設定やインフラストラクチャのセットアップは不要です。
Notionでのコンテンツ変更は、APIを通じて即座に利用可能。ビルドステップや手動同期は不要です。
## コアコンセプト
### タイプセーフなクエリ
完全なTypeScriptサポートでコンテンツをクエリ：
```typescript theme={null}
import { Client } from "notcms";
import { schema } from "./schema";
const nc = new Client({ schema });
// 完全に型付けされたレスポンス
const [posts, error] = await nc.query.blog.list();
// posts: Array<{
// title: string,
// content: string,
// properties: {
// published: boolean,
// author: string
// }
// }>
```
### スキーマファーストアプローチ
NotCMSはNotionデータベースからTypeScriptスキーマを生成し、アプリケーション全体で型安全性を保証します：
```typescript theme={null}
// 自動生成されたスキーマ
export const schema = {
blog: {
id: "your_database_id",
properties: {
title: "title",
published: "checkbox",
author: "rich_text"
}
}
} satisfies Schema;
```
### エラーハンドリング
NotCMSは予測可能なエラー管理のためにタプルベースのエラーハンドリングパターンを使用します：
```typescript theme={null}
const [data, error, response] = await nc.query.blog.get(pageId);
if (error) {
console.error("取得に失敗しました:", error.message);
return;
}
// データを安全に使用
console.log(data.title);
```
## なぜ生のNotion APIではなくNotCMSなのか？
Notion APIは強力ですが、コンテンツ管理に直接使用すると大きな課題があります：
### 生のNotion APIの課題
* **複雑なAPIクエリ**: Notionの複雑なクエリ構文とプロパティ構造を学習する必要があります
* **TypeScriptサポートなし**: クエリ結果に型定義がなく、ランタイムエラーやIDEサポートの欠如につながります
* **メンテナンスの悪夢**: Notionのプロパティを更新すると、アプリケーション全体でコードを手動で更新する必要があります
* **コンテンツ変換**: NotionブロックをMarkdownやHTMLに変換するカスタムコードを書く必要があります
* **画像ホスティングの問題**: Notionの画像URLは期限切れになるため、独自の画像再ホスティングソリューションを実装する必要があります
### NotCMSがこれらの問題を解決する方法
NotCMSはこれらの複雑さをすべて処理します：
```typescript theme={null}
// ❌ 生のNotion API - 複雑でエラーが発生しやすい
const response = await notion.databases.query({
database_id: 'abc123',
filter: {
property: 'Published',
checkbox: { equals: true }
}
});
// TypeScriptサポートなし、手動の型アサーションが必要
const title = (response.results[0].properties.Title as any).title[0].plain_text;
// ✅ NotCMS - シンプルでタイプセーフ
const [posts, error] = await nc.query.blog.list();
// 完全なTypeScriptサポート、IDE自動補完が機能
posts.forEach(post => console.log(post.title));
```
NotCMSを使用すると、以下が得られます：
* Notionデータベースから**自動生成されたTypeScript型**
* JavaScript開発者にとって自然な**シンプルで直感的なAPI**
* Markdownへの**自動コンテンツ変換**
* すぐに使える**永続的な画像ホスティング**
* Notionスキーマ変更時に**CLIで即座に更新を取得**
## 次のステップ
5分以内にNotCMSをプロジェクトに設定
NotCMSをインストールして環境を設定
完全なSDKドキュメントを探索
実際の例でNotCMSの動作を確認