Metadata-Version: 2.4
Name: feed-all
Version: 0.2.0
Summary: Portable RSS, Atom, webpage tracking, and MCP service
Author: Moon84
License-Expression: MIT
Project-URL: Repository, https://github.com/Moon84/EntroFeed_Reader
Project-URL: Skill, https://github.com/Moon84/feed-all-skill
Keywords: rss,atom,mcp,claude,codex
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: feedparser>=6.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: mcp>=1.0.0

# feed-all

Portable RSS, Atom, webpage subscription, article reading, and MCP service.

## Install

The workspace implementation is currently `0.2.0`. For a local checkout:

```bash
uv run --directory rss-plugin feed-all
```

After a release is published to PyPI, the portable installation is:

```bash
uvx feed-all
```

Use `FEED_ALL_DATA_DIR` to select the SQLite data directory. The default is
`~/.feed-all`. Local/private URLs are disabled by default; set
`FEED_ALL_ALLOW_PRIVATE_URLS=1` only for controlled tests.

## Host configuration

Claude Code/Desktop and compatible MCP hosts use JSON:

```json
{
  "mcpServers": {
    "feed-all": {
      "command": "uvx",
      "args": ["feed-all"]
    }
  }
}
```

For a local checkout, replace the command and args with:

```json
{
  "command": "uv",
  "args": ["run", "--directory", "/ABSOLUTE/PATH/rss-plugin", "feed-all"]
}
```

Codex uses TOML:

```toml
[mcp_servers.feed_all]
command = "uvx"
args = ["feed-all"]
```

The MCP `tools/list` response is the authoritative runtime contract. The
current tool names are recorded in `references/tools.md`.

## Workflow

1. Discover or preview a URL with `rss_discover` or `rss_fetch`.
2. Subscribe with `rss_subscribe` (`rss`, `atom`, or `webpage`).
3. Refresh one source or all sources with `rss_refresh`.
4. Search and read with `rss_list_entries`, `rss_search`, and `rss_get_entry`.
5. Use `rss_check_health` when diagnosing a source.

The skill documentation is available in `SKILL.md`. The compatibility skill
name `rss-plugin-installer` is retained for hosts that use the GitHub skill's
original trigger name.
