---

name: search-articles description: Query articles using category filters and BM25 keyword search version: 3.0.0 provider: fastpaip runtime: python3 tags: [search, articles, bm25, filtering, query]

Search Articles

Query articles using structured category filters and BM25 full-text keyword search.

Usage

Copy# List available categories
python search.py --list-categories

# Browse all articles
python search.py --limit 10

# Filter by categories
python search.py --categories NEWS SCIENTIFIC

# Keyword search (BM25 full-text search)
python search.py --keywords "machine learning"

# Combined filters
python search.py --categories SCIENTIFIC --keywords "biology"

# JSON output for piping
python search.py --keywords "API" --format json | jq '.results[].id'

Parameters

Output Formats

Table (default)

Copy                 Search Results (3 found)
┏━━━━┳━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ Category   ┃ Score ┃ Snippet                  ┃
┡━━━━╇━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 6  │ SCIENTIFIC │ 0.15  │ ...machine learning...   │
└────┴────────────┴───────┴──────────────────────────┘

JSON

Copy{
  "results": [
    {
      "id": 6,
      "raw_article": "...",
      "category": "SCIENTIFIC",
      "keyword_score": 0.15,
      "snippet": "...machine learning..."
    }
  ],
  "metadata": {
    "total_results": 3,
    "query_time_ms": 42.5,
    "strategies_used": ["bm25_keyword_search", "category_filter"]
  }
}

CSV

Copyid,raw_article,category,keyword_score,snippet
6,"...","SCIENTIFIC",0.15,"...machine learning..."

Examples

See references/examples.md for 30+ usage examples including:

• Category filtering
• Keyword search strategies
• Date range queries
• Pagination
• Composing with jq, grep, and other tools
• Batch processing workflows