# Paper Search With Citation

> Use when working with the Academic Paper Search and BibTeX Generation API, including searching papers, retrieving BibTeX citations, and monitoring API manager statistics

- Skill: `livxue/paper-search-with-citation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add livxue/paper-search-with-citation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/livxue/paper-search-with-citation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: LivXue (https://skillmd.com/u/livxue)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/livxue/paper-search-with-citation

---


# Academic Search API Usage Guide

## Overview

This skill provides comprehensive usage instructions for the Academic Paper Search and BibTeX Generation API, which supports Semantic Scholar API with advanced multi-API key and proxy management. The API offers endpoints for searching papers, retrieving BibTeX citations from DOIs, and monitoring API manager statistics.

## When to Use

- Searching academic papers using keywords with optional year filtering
- Retrieving BibTeX citations for papers using DOI
- Checking API health and manager statistics
- Monitoring API key and proxy configuration status
- Checking API key keep-alive task status
- Manually triggering keep-alive checks for idle API keys
- Formatting API responses using jq

## API Access Information

- **Base URL**: http://localhost:8111
- **API Documentation**: http://localhost:8111/docs

## Calling the API with curl

### 1. Health Check

```bash
curl http://localhost:8111/health
```

### 2. Search Papers (POST Method)

```bash
curl -X POST "http://localhost:8111/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "attention",
    "limit": 3,
    "include_bibtex": true
  }'
```

### 3. Search Papers (GET Method)

```bash
curl "http://localhost:8111/search?query=attention&limit=3&include_bibtex=true&year=2020-2023"
```

**Parameter Description:**
- `query`: Search keywords (required)
- `limit`: Number of results to return, range 1-20 (optional, default 3)
- `include_bibtex`: Whether to include BibTeX, true/false (optional, default true)
- `year`: Publication year filter (optional). Supported formats:
  - Single year: `"2020"`
  - Range: `"2016-2020"`
  - From year: `"2010-"`
  - To year: `"-2015"`

### 4. Get BibTeX Citation (POST Method)

```bash
curl -X POST "http://localhost:8111/bibtex" \
  -H "Content-Type: application/json" \
  -d '{"doi": "10.48550/arXiv.1706.03762"}'
```

### 5. Get BibTeX Citation (GET Method)

```bash
curl "http://localhost:8111/bibtex/10.48550/arXiv.1706.03762"
```

**Parameter Description:**
- `doi`: DOI of the paper (required)

### 6. View API Manager Statistics

```bash
curl "http://localhost:8111/manager/stats"
```

Return information includes:
- Total configurations
- Healthy configurations
- Rate-limited configurations
- Proxied configurations
- Current index

### 7. Formatted Output (Using jq)

If `jq` is installed, you can use it to format JSON output:

```bash
# Search and format output
curl "http://localhost:8111/search?query=attention&limit=2" | jq .

# Show only paper titles
curl "http://localhost:8111/search?query=attention&limit=3" | jq -r '.papers[].title'

# Get BibTeX and save to file
curl "http://localhost:8111/bibtex/10.48550/arXiv.1706.03762" | jq -r '.bibtex' > paper.bib
```