SciX / NASA ADS

scix-client

scix-client を使うと、AI アシスタントから SciX／NASA ADS データベースに直接アクセスできます。自然言語で文献を検索し、参考文献リストを作成し、引用ネットワークを分析し、個人ライブラリを管理し、SIMBAD／NED で天体名を解決し、BibTeX、AASTeX、その他 15 種類の形式で参考文献をエクスポートできます。

単体でも使用できます。CLI ツール、Python ライブラリ、Rust クレートとして利用できます。

研究ワークフロー： 文献レビュー、参考文献管理、引用分析、参考文献のエクスポート、天体名の解決、論文の詳細情報、ライブラリの共同作業、注釈／メモ

1 つのバイナリ（scix）ですべてを実行できます。Python バインディングは Rust の型から自動生成されるため、追加のメンテナンスは不要です。

https://ui.adsabs.harvard.edu/user/settings/token から無料の SciX／ADS API トークンを取得してください。以下のどの方法でも、トークンを一度入力すれば保存されます。

Claude Desktop：ワンクリックでインストール

1. 最新リリースから scix-vX.Y.Z.mcpb をダウンロードします（macOS ユニバーサル版と Windows 版が 1 つのファイルに含まれています）。
2. ダブルクリックするか、Claude Desktop → Settings → Extensions にドラッグします。
3. 求められたら API トークンを貼り付けます。これで完了です。ターミナルも、PATH の設定も、JSON も必要ありません。

それ以外の場合：scix をインストールしてから scix setup を実行

インストーラーを 1 つ選びます。

# One-line installer (prebuilt binary, no Rust toolchain)
curl -sSf https://raw.githubusercontent.com/yipihey/scix-client/main/install.sh | sh

# Python (also gives you the scix_client module)
pip install scix-client        # or: pipx install scix-client / uv tool install scix-client

# Rust
cargo install scix-client      # compiles locally
cargo binstall scix-client     # prebuilt binary via cargo-binstall

次に、以下を実行します。

scix setup

ウィザードでトークンを入力すると（トークンのページを開くよう提案されます）、検証後に ~/.config/scix/token に保存され、検出されたすべてのエディター（Claude Code、Claude Desktop、Cursor、Zed、Gemini CLI、Codex CLI、Windsurf）にサーバーが登録されます。いつでも再実行でき、何度実行しても安全です。

• scix setup claude-code — 1 つのエディターのみを設定します
• scix setup --yes — 非対話型で実行します（SCIX_API_TOKEN を使用し、検出されたすべてのエディターを設定します）
• scix login — トークンのみを保存し、エディターの設定には触れません
• scix doctor — バイナリ、PATH、トークン、API 接続、および検出されたエディターを確認します

インストールバッジ

scix login の実行後は、どの MCP ホストでも環境設定なしで scix serve を実行できます。

GUI エディターからはシェルの PATH が見えません。バッジからインストールしたサーバーが scix を見つけられない場合は、scix setup cursor（または使用するエディター名）を一度実行してください。絶対パスが書き込まれます。

インストール不要で使う

uv があれば、任意の MCP 設定で次のコマンドを使用できます。

{ "command": "uvx", "args": ["scix-client", "serve"], "env": { "SCIX_API_TOKEN": "your-token" } }

手動設定

claude mcp add --scope user scix -- scix serve

{
  "mcpServers": {
    "scix": {
      "command": "/full/path/to/scix",
      "args": ["serve"],
      "env": { "SCIX_API_TOKEN": "your-token-here" }
    }
  }
}

Cursor、VS Code、Zed、Gemini CLI、Codex CLI、Windsurf の設定、ツールの完全なリファレンス、およびワークフローの例については、docs/mcp-server.md を参照してください。

クイックスタート：CLI

scix search 'first_author:"Perlmutter" supernova' --sort "citation_count desc"
scix export 1999ApJ...517..565P --format bibtex
scix cites 1999ApJ...517..565P --rows 50
scix libraries create "Thesis Papers" --description "Key references"

ライブラリの権限、ノート、セット操作を含むすべてのコマンドについては、docs/cli.md を参照してください。

クイックスタート：Python

pip install scix-client

import scix_client

client = scix_client.SciXClient()   # token from SCIX_API_TOKEN or ~/.config/scix/token
results = client.search('author:"Einstein" year:1905', rows=5)
for paper in results.papers:
    print(f"{paper.title} ({paper.year}) — {paper.citation_count} citations")

このホイールをインストールすると scix コマンドもインストールされるため、pip install scix-client && scix setup だけで MCP のセットアップが完了します。API リファレンス全体については、docs/python.md を参照してください。

クイックスタート：Rust

[dependencies]
scix-client = { version = "0.4", default-features = false }   # library only, no CLI deps

use scix_client::SciXClient;

#[tokio::main]
async fn main() -> scix_client::error::Result<()> {
    let client = SciXClient::from_env()?;
    let results = client.search("author:\"Einstein\" year:1905", 5).await?;
    for paper in &results.papers {
        println!("{} — {} citations", paper.title, paper.citation_count.unwrap_or(0));
    }
    Ok(())
}

API 全体、エラー処理、アーキテクチャについては、docs/rust.md を参照してください。

クエリ構文クイックリファレンス

ブール演算子： AND、OR、NOT、括弧 関数： citations(bibcode:X)、references(bibcode:X)、similar(bibcode:X) 並べ替え： date desc（デフォルト）、citation_count desc、score desc、read_count desc

17 種類すべてのエクスポート形式を含む完全なリファレンスについては、docs/query-syntax.md を参照してください。

トークンの検索順序

scix（および Python／Rust クライアントの from_env）は、次の順序で API トークンを探します。

1. SCIX_API_TOKEN 環境変数
2. ADS_API_TOKEN 環境変数
3. ~/.config/scix/token（Windows では %APPDATA%\scix\token。SCIX_CONFIG_DIR でディレクトリを変更できます）。scix login／scix setup によって書き込まれます。

レート制限

SciX API では、1 日あたり 5,000 件、1 秒あたり 5 件のリクエストが許可されています。scix-client はレート制限を自動的に処理します。トークンバケット方式のレートリミッターによってローカルで 1 秒あたり 5 件に制限され、API のレート制限ヘッダーも尊重されます。

ライセンス

MIT