Skip to content

Paper Command

The paper command provides detailed information about a specific research paper using its ArXiv ID.

Basic Usage

scoutml paper ARXIV_ID [OPTIONS]

Examples

Get Paper Details

# Basic paper information
scoutml paper 1810.04805

# Include similar papers
scoutml paper 1810.04805 --similar

# More similar papers
scoutml paper 1810.04805 --similar --similar-limit 10

Options

Option Type Default Description
--similar/--no-similar FLAG False Include similar papers
--similar-limit INTEGER 5 Number of similar papers to show
--output CHOICE rich Output format: rich/json
--export PATH None Export results to file

Output Information

The command displays:

Basic Information

  • Title: Full paper title
  • Authors: Complete author list
  • Year: Publication year
  • Abstract: Full abstract text
  • ArXiv URL: Direct link to paper

Metrics

  • Citations: Current citation count
  • Citation Velocity: Citations per year
  • Impact Score: Relative impact metric

Categories

  • Primary and secondary ArXiv categories
  • Research domains

Optional: Similar Papers

When using --similar: - Related papers by content - Similarity scores - Brief descriptions

ArXiv ID Format

ArXiv IDs follow these patterns:

New Format (2007+)

# YYMM.NNNNN
scoutml paper 2103.00020  # CLIP paper
scoutml paper 1810.04805  # BERT paper

Old Format (pre-2007)

# category/YYMMNNN
scoutml paper cs/0301001

Advanced Usage

Finding Paper IDs

Get ArXiv IDs from search results:

# Search first
scoutml search "BERT" --limit 5

# Then get details
scoutml paper 1810.04805

Batch Processing

Process multiple papers:

# Create list of paper IDs
cat > papers.txt << EOF
1810.04805
2103.00020
2010.11929
EOF

# Get details for each
while read -r paper_id; do
    echo "=== Paper: $paper_id ==="
    scoutml paper "$paper_id" --output json > "${paper_id}.json"
done < papers.txt

Building Reading Lists

Find related papers to explore:

# Start with one paper
scoutml paper 1706.03762 --similar --similar-limit 10

# Export for reading list
scoutml paper 1706.03762 --similar \
  --output json \
  --export transformer_related.json

Output Formats

Rich Format (Default)

scoutml paper 1810.04805

Displays formatted panels with: - Colored sections - Formatted text - Clear hierarchy - Hyperlinks

JSON Format

scoutml paper 1810.04805 --output json

Returns structured data: 

{
  "arxiv_id": "1810.04805",
  "title": "BERT: Pre-training of Deep Bidirectional...",
  "authors": ["Jacob Devlin", "Ming-Wei Chang", ...],
  "abstract": "We introduce a new language representation...",
  "year": 2018,
  "citations": 50000,
  "categories": ["cs.CL"],
  "similar_papers": []
}

Use Cases

Literature Review

Build comprehensive reading lists:

# Core paper
scoutml paper 1810.04805 --similar --similar-limit 20 \
  --export bert_family.json

# Process similar papers
cat bert_family.json | \
  jq -r '.similar_papers[].arxiv_id' | \
  xargs -I {} scoutml paper {} --output json

Research Genealogy

Trace paper influences:

# Original paper
scoutml paper 1706.03762  # Attention is All You Need

# Find descendants
scoutml paper 1706.03762 --similar --similar-limit 15

Quick Reference

Create reference sheets:

# Export key papers as JSON
for paper in 1810.04805 2103.00020 1908.08962; do
    scoutml paper $paper --output json >> key_papers.json
done

Similar Papers Feature

Understanding Similarity

Papers are matched based on: - Abstract content similarity - Shared citations - Common authors - Research domains

Similarity Scores

  • 90-100%: Nearly identical topics
  • 80-89%: Highly related work
  • 70-79%: Same domain, different approach
  • Below 70%: Loosely related

Finding Research Threads

# Start with seminal paper
scoutml paper 1706.03762 --similar

# Explore each branch
scoutml paper 1810.04805 --similar  # BERT branch
scoutml paper 2010.11929 --similar  # ViT branch

Tips and Tricks

Paper Discovery Workflow

  1. Start with a known good paper
  2. Get similar papers
  3. Check citations and impact
  4. Read abstracts
  5. Dive deep into promising papers

Creating Bibliography

# Export paper details for citation
scoutml paper 1810.04805 --output json | \
  jq '{
    title: .title,
    authors: .authors,
    year: .year,
    url: "https://arxiv.org/abs/\(.arxiv_id)"
  }'

Tracking Paper Impact

# Monitor citation growth
scoutml paper 2103.00020 --output json | \
  jq '{
    title: .title,
    citations: .citations,
    citations_per_year: .citation_velocity,
    years_since_publication: (2024 - .year)
  }'

Common Issues

Invalid ArXiv ID

If you get an error: 1. Check ID format (YYMM.NNNNN) 2. Verify the paper exists on ArXiv 3. Remove any version suffix (v1, v2)

Paper Not Found

Possible causes: 1. Very recent paper (not yet indexed) 2. Withdrawn paper 3. Incorrect ID format