開発者向けドキュメント
Litra.aiの公開APIとMCPサーバーを使って、AIエージェントやアプリケーションから論文検索機能を利用できます。
クイックスタート
1. アカウント作成
Litra.aiにサインアップし、有料プラン（Mini以上）に加入します。
2. APIキーを発行
アカウントページの「APIキー管理」セクションから、APIキーを発行します。
3. APIを呼び出す
発行したAPIキーを使って、REST APIまたはMCPサーバー経由で論文を検索します。
APIリファレンス
ベースURL
https://litra-ai.com/api/v1認証
すべてのリクエストにBearerトークンとしてAPIキーを含めてください。
Authorization: Bearer YOUR_API_KEYPOST
/api/v1/search論文検索
キーワードやフレーズで論文を検索します。AIがクエリの意味を理解し、関連性の高い論文を返します。
POST
/api/v1/author/search著者検索
著者名で論文を検索します。
GET
/api/v1/creditsクレジット残高確認
現在のクレジット残高を確認します。
curl -X POST https://litra-ai.com/api/v1/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "sleep deprivation memory consolidation",
"max_results": 10
}'エラーコード
| コード | 説明 |
|---|---|
401 | 認証エラー: APIキーが無効または未指定です |
402 | クレジット不足: 残高が不足しています |
429 | レートリミット: リクエスト数の上限を超えました |
500 | サーバーエラー: しばらくしてからお試しください |
MCPサーバー
MCP（Model Context Protocol）を使えば、AIエージェントからLitra.aiの論文検索を直接利用できます。以下のクライアントに対応しています。
claude mcp add litra \
-- npx -y @anthropic-ai/mcp-remote \
https://litra-ai.com/api/v1/mcp \
--header "Authorization: Bearer YOUR_API_KEY"料金とレートリミット
API / MCPの利用には、Webアプリと同じクレジットを消費します。プランごとのレートリミットは以下の通りです。
| プラン | クレジット/月 | レートリミット |
|---|---|---|
| ミニ | 30 | 10 req/min |
| スタンダード | 100 | 30 req/min |
| プロ | 400 | 60 req/min |
| マックス | 1200 | 120 req/min |
よくある質問
APIキーは何個まで発行できますか？
1アカウントにつき最大5個までAPIキーを発行できます。
APIの利用にクレジットは消費されますか？
はい。API経由の検索はWebアプリでの検索と同じクレジットを消費します。
レートリミットを超えた場合はどうなりますか？
429エラーが返されます。しばらく待ってからリトライしてください。
MCPサーバーの設定がうまくいきません。
APIキーが正しく設定されているか確認してください。それでも解決しない場合はお問い合わせください。