bbc-news

# BBC News

Fetch top stories from BBC News across different sections and regions.

## Quick Start

Fetch top stories:
```bash
python3 scripts/bbc_news.py
```

Fetch from specific section:
```bash
python3 scripts/bbc_news.py uk
python3 scripts/bbc_news.py world
python3 scripts/bbc_news.py technology
```

List all available sections:
```bash
python3 scripts/bbc_news.py --list
```

## Available Sections

### Main Sections
- `top` - Top stories (default)
- `uk` - UK news
- `world` - World news
- `business` - Business news
- `politics` - Politics
- `health` - Health news
- `education` - Education
- `science` - Science & Environment
- `technology` - Technology news
- `entertainment` - Entertainment & Arts

### UK Regional
- `england` - England news
- `scotland` - Scotland news
- `wales` - Wales news
- `northern-ireland` - Northern Ireland news

### World Regions
- `africa` - Africa news
- `asia` - Asia news
- `australia` - Australia news
- `europe` - Europe news
- `latin-america` - Latin America news
- `middle-east` - Middle East news
- `us-canada` - US & Canada news

## Options

**Limit number of stories:**
```bash
python3 scripts/bbc_news.py world --limit 5
```

**JSON output:**
```bash
python3 scripts/bbc_news.py technology --json
```

## Examples

Get top 5 UK stories:
```bash
python3 scripts/bbc_news.py uk --limit 5
```

Get Scotland news in JSON:
```bash
python3 scripts/bbc_news.py scotland --json
```

Get latest technology headlines:
```bash
python3 scripts/bbc_news.py technology --limit 3
```

## Dependencies

Requires `feedparser`:
```bash
pip3 install feedparser
```

## Resources

### scripts/bbc_news.py
Python CLI that fetches and displays BBC News stories from RSS feeds. Supports all major BBC sections and regions, with text and JSON output formats.

### references/feeds.md
Complete list of BBC News RSS feed URLs organized by section and region.

# BBC News Skill

A Clawdbot skill for fetching BBC News stories from various sections and regions via RSS feeds.

## Features

- 📰 **Multiple Sections**: Top stories, UK, World, Business, Politics, Health, Education, Science, Technology, Entertainment
- 🌍 **UK Regional News**: England, Scotland, Wales, Northern Ireland
- 🗺️ **World Regions**: Africa, Asia, Australia, Europe, Latin America, Middle East, US & Canada
- 📊 **Flexible Output**: Text or JSON format
- ⚙️ **Customizable**: Limit number of stories

## Installation

### Via ClawdHub

```bash
clawdhub install bbc-news
```

### Manual Installation

```bash
# Clone the repo
git clone https://github.com/ddrayne/bbc-news-skill.git ~/.clawdbot/skills/bbc-news

# Install dependencies
pip3 install feedparser
```

## Usage

### With Clawdbot

Ask your agent:
- "What's the latest BBC news?"
- "Show me UK technology news from BBC"
- "Get top 5 Scotland stories"

### Direct Script Usage

```bash
# Top stories (default)
python3 ~/.clawdbot/skills/bbc-news/scripts/bbc_news.py

# Specific section
python3 ~/.clawdbot/skills/bbc-news/scripts/bbc_news.py technology

# Limit results
python3 ~/.clawdbot/skills/bbc-news/scripts/bbc_news.py uk --limit 5

# JSON output
python3 ~/.clawdbot/skills/bbc-news/scripts/bbc_news.py world --json

# List all sections
python3 ~/.clawdbot/skills/bbc-news/scripts/bbc_news.py --list
```

## Available Sections

### Main Sections
`top`, `uk`, `world`, `business`, `politics`, `health`, `education`, `science`, `technology`, `entertainment`

### UK Regional
`england`, `scotland`, `wales`, `northern-ireland`

### World Regions
`africa`, `asia`, `australia`, `europe`, `latin-america`, `middle-east`, `us-canada`

## Dependencies

- Python 3
- feedparser (`pip3 install feedparser`)

## License

MIT