citation-finder

# Citation Finder Skill

## Description

Academic citation lookup and formatter. Given a fuzzy paper title or description (in Chinese or English), searches both Chinese and English academic databases, identifies the most likely paper, and returns formatted citations in GB/T 7714, APA, and MLA formats along with source links.

## Trigger Conditions

Use this skill when the user:
- Asks to find a paper or citation (e.g. "帮我找这篇文献", "cite this paper", "这篇论文怎么引用")
- Provides a fuzzy or partial paper title in Chinese or English
- Asks to format a reference in GB/T 7714, APA, or MLA
- Uses keywords: 参考文献, 引用格式, 文献查找, find paper, citation, reference, cite

## Workflow

1. Detect input language (Chinese / English / mixed)
2. Search **in parallel**:
   - English: CrossRef API + Semantic Scholar API
   - Chinese: Baidu Scholar (web scrape) + CNKI search
3. Score and rank candidates by title similarity + metadata completeness
4. If top match confidence > 80%: return directly
5. If confidence 50–80%: show top 3 candidates, ask user to confirm
6. If confidence < 50%: inform user and ask for more details
7. Format confirmed paper into GB/T 7714, APA 7th, MLA 9th
8. Return citations + DOI/source URL

## Usage

```
用法：直接描述或粘贴模糊文献标题
示例：帮我找一下 "注意力机制在自然语言处理中的应用" 这篇论文的引用格式
示例：find citation for "attention is all you need"
```

## Scripts

- `scripts/search_en.py` — CrossRef + Semantic Scholar search
- `scripts/search_cn.py` — Baidu Scholar + CNKI search  
- `scripts/format_cite.py` — Citation formatter (GB/T 7714, APA, MLA)
- `scripts/run.py` — Main entry point (orchestrates all steps)

## Dependencies

```
requests>=2.28.0
beautifulsoup4>=4.11.0
rapidfuzz>=3.0.0
```

Install: `pip install requests beautifulsoup4 rapidfuzz`

# Citation Finder 文献查找与引文格式化

> 输入模糊文献标题，自动搜索中英文学术数据库，返回 GB/T 7714、APA、MLA 三种标准引文格式。

---

## ✨ 功能

- 🔍 **双语搜索**：同时搜索中文（百度学术、CNKI）和英文（CrossRef、Semantic Scholar）数据库
- 🎯 **模糊匹配**：基于标题相似度算法，处理不完整或有误的标题
- 📝 **三种格式**：一键输出 GB/T 7714-2015、APA 7th、MLA 9th 引文
- 🔗 **原始链接**：提供 DOI 或数据库链接方便原文查阅
- 🤔 **歧义处理**：匹配度不足时列出候选，由用户确认

---

## 🚀 快速开始

### 安装依赖

```bash
pip install requests beautifulsoup4 rapidfuzz
```

### 命令行使用

```bash
# 英文文献
python scripts/run.py "attention is all you need"

# 中文文献
python scripts/run.py "注意力机制在自然语言处理中的应用"

# 模糊描述
python scripts/run.py "transformer architecture neural machine translation 2017"
```

### 作为 OpenClaw Skill 使用

本项目为 [OpenClaw](https://openclaw.woa.com) Agent Skill 格式，安装后可直接通过对话触发：

> "帮我找一下 Attention is All You Need 的引用格式"

---

## 📁 项目结构

```
citation-finder-skill/
├── SKILL.md              # OpenClaw skill 配置
├── README.md
├── scripts/
│   ├── run.py            # 主入口
│   ├── search_en.py      # 英文搜索（CrossRef + Semantic Scholar）
│   ├── search_cn.py      # 中文搜索（百度学术 + CNKI）
│   └── format_cite.py    # 引文格式化（GB/T 7714 / APA / MLA）
└── assets/
```

---

## 📖 引文格式示例

输入：`attention is all you need`

**GB/T 7714-2015**
```
Vaswani A., Shazeer N., Parmar N., 等. Attention Is All You Need[J]. Advances in Neural Information Processing Systems, 2017, 30: 5998-6008. DOI: 10.48550/arXiv.1706.03762.
```

**APA 7th**
```
Vaswani, A., Shazeer, N., Parmar, N., Uszkoreit, J., Jones, L., Gomez, A. N., Kaiser, Ł., & Polosukhin, I. (2017). Attention is all you need. Advances in Neural Information Processing Systems, 30, 5998-6008. https://doi.org/10.48550/arXiv.1706.03762
```

**MLA 9th**
```
Vaswani, Ashish, et al. "Attention Is All You Need." Advances in Neural Information Processing...