← Back to Skills Marketplace
antonia-sz

citation-finder

by antonia huang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
359
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install citation-finder
Description
Academic citation lookup and formatter. Given a fuzzy paper title (Chinese or English), searches CrossRef, Semantic Scholar, Baidu Scholar, and CNKI, then re...
README (SKILL.md)

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 \x3C 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

Usage Guidance
This skill appears to do what it says: it searches public APIs and scrapes Chinese search pages, then formats citations. Things to consider before installing: (1) it will make outbound HTTP requests to CrossRef, Semantic Scholar, Baidu Scholar, and CNKI — avoid sending sensitive or private data as the query. (2) Web scraping (Baidu/CNKI) may be blocked, fragile, or violate site terms; expect occasional failures or missing results. (3) There's a small documentation/code mismatch: SKILL.md's confidence thresholds differ from run.py's numeric thresholds (80/50 vs 75/45); behavior you see will follow the code. (4) No credentials are requested and no unusual file/system access occurs. If you need stricter guarantees, review the code yourself (it's included) or run it in an isolated environment and verify outputs before relying on citations in formal work.
Capability Analysis
Type: OpenClaw Skill Name: citation-finder Version: 1.0.0 The citation-finder skill is a legitimate academic tool designed to search for research papers and format citations in GB/T 7714, APA, and MLA styles. The code uses standard libraries (requests, BeautifulSoup, rapidfuzz) to query public APIs (CrossRef, Semantic Scholar) and scrape academic search engines (Baidu Scholar, CNKI) as described in the documentation. No evidence of data exfiltration, malicious execution, or prompt injection was found across the scripts (run.py, search_en.py, search_cn.py, format_cite.py).
Capability Assessment
Purpose & Capability
Name/description (citation lookup + formatting) align with the included scripts: English searches use CrossRef and Semantic Scholar APIs; Chinese searches scrape Baidu Scholar and CNKI; formatting produces GB/T 7714, APA, and MLA. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
Runtime instructions and code stay within the stated purpose (search, rank, and format). Minor inconsistencies: SKILL.md states confidence thresholds (>80% direct, 50–80% ask to confirm) whereas run.py uses 75/45 thresholds (CONFIDENCE_HIGH=75, CONFIDENCE_MID=45). Also the skill performs web scraping of Baidu Scholar and CNKI (documented), which is expected but may be brittle or subject to anti-scraping/TOS concerns; the code does not attempt to read unrelated files or environment variables.
Install Mechanism
No install spec (instruction-only skill) and only standard Python dependencies (requests, beautifulsoup4, rapidfuzz) are required via pip. There are no downloads from untrusted URLs or archive extraction steps.
Credentials
The skill declares no required environment variables, no credentials, and no config paths. The code does perform outbound HTTP calls to public APIs and web pages (CrossRef, Semantic Scholar, xueshu.baidu.com, kns.cnki.net) which is consistent with its stated purpose.
Persistence & Privilege
Skill is not forced-always (always:false) and uses normal autonomous invocation settings. It does not modify other skills or system config and does not request persistent elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install citation-finder
  3. After installation, invoke the skill by name or use /citation-finder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Citation Finder Skill 1.0.0 – Initial release - Searches academic papers by fuzzy title in Chinese or English. - Supports CrossRef, Semantic Scholar, Baidu Scholar, and CNKI sources. - Returns formatted citations in GB/T 7714, APA 7th, and MLA 9th styles, with source links. - Handles low-confidence matches by prompting for confirmation. - Easy usage: simply enter a paper title or citation request. - Dependencies: requests, beautifulsoup4, rapidfuzz.
Metadata
Slug citation-finder
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is citation-finder?

Academic citation lookup and formatter. Given a fuzzy paper title (Chinese or English), searches CrossRef, Semantic Scholar, Baidu Scholar, and CNKI, then re... It is an AI Agent Skill for Claude Code / OpenClaw, with 359 downloads so far.

How do I install citation-finder?

Run "/install citation-finder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is citation-finder free?

Yes, citation-finder is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does citation-finder support?

citation-finder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created citation-finder?

It is built and maintained by antonia huang (@antonia-sz); the current version is v1.0.0.

💬 Comments