Cire — Cosmetic Ingredient Risk Engine

CIRE API — 化粧品成分リスクエンジン

AI エージェント向けの、決定論的な INCI 安全性スコアリング API です。
ショッピングエージェント、カタログフィルター、コンプライアンスパイプライン、K-beauty レコメンデーションエンジン向けに設計されています。

---

CIRE とは？

CIRE は、化粧品成分リスト（INCI 形式）を、次の 5 つのカテゴリにわたって安全性リスク評価します。

カテゴリ	説明
irritation_risk	皮膚刺激の可能性
allergen_risk	既知のアレルゲン
pregnancy_risk	妊娠中に安全でない成分
acne_risk	コメドを引き起こす成分
interaction_risk	危険な成分の組み合わせ

完全に決定論的です。ルールベースです。ML は使用しません。有効な JSON を常に返します。

---

クイックスタート

curl -X POST https://web-production-9cdb4.up.railway.app/v1/analyze \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inci": "Water, Retinol, Glycolic Acid"}'

レスポンス：

{
  "risk_score": 52,
  "risk_level": "moderate",
  "confidence_score": 65,
  "category_results": { ... },
  "matches": { ... }
}

• risk_score：0～100（値が高いほど安全）
• risk_level：low / moderate / high
• confidence_score：エビデンスの強さ（0～100）

---

認証

X-API-Key ヘッダーに API キーを指定します。

X-API-Key: cire-xxxxxxxxxxxx

API キーを取得 → cire.ai

---

料金

プラン	呼び出し回数	料金
Starter	1,000	$9
Growth	10,000	$49
Scale	100,000	$299

ティアごとの動作

• Free ティアの API キー：/v1/analyze、/v1/credits、課金／アカウントの各エンドポイントを呼び出せます
• Pro ティアの API キー：Free のエンドポイントに加え、/v1/synergy と /v1/optimal を利用できます
• Free キーで Pro エンドポイントを呼び出すと、次の内容が返されます。
  • 403 Forbidden
  • 明確なメッセージ：Pro tier required for this endpoint...

---

API リファレンス

インタラクティブなドキュメント全文はこちら：/docs

開発者向けエントリーポイント：

• 開発者向けクイックスタート

ユースケースの記事：

• AI ショッピングエージェント向け安全性 API
• K-Beauty コンプライアンス INCI API
• CIRE Pro：相乗効果 + 最適化

POST /v1/analyze

INCI 文字列を分析します。1 クレジットを消費します。

POST /v1/batch

リクエストごとに最大 100 件の INCI 文字列を一括分析します。1 件につき 1 クレジットを消費します。

リクエスト：

{ "inci_list": ["Water, Glycerin", "Water, Retinol, Glycolic Acid"] }

POST /v1/synergy (Pro tier)

有益な組み合わせとリスクのある組み合わせを、決定論的にスコアリングします。

リクエスト：

{ "inci": "Water, Adapalene, Benzoyl Peroxide" }

レスポンスには次の項目が含まれます。

• synergy_score
• conflict_score
• evidence_level
• evidence_refs

POST /v1/optimal (Pro tier)

目標に基づいた、決定論的な推奨を行うエンドポイントです。

リクエスト：

{ "inci": "Water, Niacinamide", "goal": "acne" }

レスポンスには次の項目が含まれます。

• recommended_additions
• avoid_with_current
• evidence_level
• evidence_refs

GET /v1/credits

残りのクレジット数とキーのティアを確認します。

課金の自動化（Paddle）

• /v1/webhook は transaction.completed イベントを処理します。
• custom_data.credits が指定されている場合、クレジットが自動的に追加されます。
• custom_data.tier が pro／enterprise の場合、API キーのティアが自動的にアップグレードされます。
• Pro サブスクリプションのチェックアウトでサポートされるパッケージ ID：pro_monthly、pro_yearly（環境変数に Paddle の価格 ID が必要です）。

---

ユースケース

• ショッピングエージェント — 妊娠中の安全性やアレルゲンリスクに基づいて商品を絞り込みます
• カタログ管理者 — 数千件の SKU を一括スキャンします
• コンプライアンスパイプライン — EU／K-beauty の輸出規制への適合を確認します
• レコメンデーションエンジン — 安全性プロファイルに基づいて商品をランク付けします

---

技術情報

• 純粋な Python で実装されており、ML 依存関係はありません
• 決定論的な出力 — 同じ入力には常に同じ出力を返します
• エビデンスに基づいています：EU 制限リスト、FDA 勧告、CIR レポート、査読済みのコンセンサス
• スモークテスト 13 件すべてに合格しています

Pro データの拡充（冪等）

Pro の処方テーブルを重複行なしで拡充するには、次のようにします。

cd cire-api
python scripts/enrich_pro_seed.py

このスクリプトは、次のレコードのうち不足しているものを追加します。

• evidence_refs
• ingredient_pairs
• formulation_goals

---

AI エージェントのエコシステム向けに構築されています。CIRE 認定。