SciX Client

scix客户端

scix客户端 让您的AI助手直接访问 SciX / 美国国家航空航天局广告 数据库。搜索文献、构建参考书目、分析引文网络、管理个人图书馆、通过SIMBAD/NED解析对象名称，以及以BibTeX、AASTeX或其他15种格式导出参考文献——所有这些都来自自然语言。

它也可以独立工作：作为CLI工具、Python库或Rust crate。

研究工作流程： 文献综述、书目管理、引文分析、参考文献导出、对象解析、论文细节、图书馆协作、注释/笔记

一个二进制(scix)什么都做。Python绑定是从Rust类型自动生成的，无需额外维护。

先决条件

您需要一个SciX/ADS API令牌。免费获取一个：

export SCIX_API_TOKEN="your-token-here"
# or, for backwards compatibility:
export ADS_API_TOKEN="your-token-here"

______________________________________________________________________

快速入门：MCP

让你的AI助手访问整个SciX数据库。

安装

cargo install scix-client --features cli
# or: cargo binstall scix-client

自动设置（推荐）

scix setup

这将检测您安装的编辑器（Claude Code、Claude Desktop、Cursor、Zed），提示您输入API令牌，验证它，并为每个编辑器编写正确的配置。运行一次，就完成了。

选项：

• scix setup claude-code --仅配置Claude代码
• scix setup --yes --非交互式（使用env令牌，配置所有检测到的编辑器）
• scix setup --skip-validation --跳过令牌验证

手动设置

Claude Code

claude mcp add scix -- /path/to/scix serve

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

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

看 docs/mcp-server.md 用于Cursor、Zed、完整工具参考和示例工作流。

______________________________________________________________________

快速入门：CLI

cargo install scix-client --features 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()
results = client.search('author:"Einstein" year:1905', rows=5)
for paper in results.papers:
    print(f"{paper.title} ({paper.year}) — {paper.citation_count} citations")

看 docs/python.md 以获取完整的API参考，包括v0.2.0库管理方法。

______________________________________________________________________

快速入门：Rust

[dependencies]
scix-client = "0.3"

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(())
}

看 docs/rust.md 用于完整的API、错误处理和体系结构。

______________________________________________________________________

查询语法快速参考

布尔值： AND, OR, NOT，括号 功能： citations(bibcode:X), references(bibcode:X), similar(bibcode:X) 排序： date desc （默认）， citation_count desc, score desc, read_count desc

看 docs/query-syntax.md 获取包括所有17种导出格式的完整参考。

______________________________________________________________________

速率限制

SciX API每天允许5000个请求，每秒允许5个请求。 scix-client 自动处理速率限制-令牌桶速率限制器在本地强制执行5 req/s，并且尊重API速率限制头。

许可证

麻省理工学院