feat: adding rss tool to Strands tool repository

Author: jimbrub

README.md

@@ -54,7 +54,8 @@ Strands Agents Tools is a community-driven project that provides a powerful set
 - 🐝 **Swarm Intelligence** - Coordinate multiple AI agents for parallel problem solving with shared memory
 - 🔄 **Multiple tools in Parallel**  - Call multiple other tools at the same time in parallel with Batch Tool
 - 🔍 **Browser Tool** - Tool giving an agent access to perform automated actions on a browser (chromium)
-
+- 📰 **RSS Feed Manager** - Subscribe, fetch, and process RSS feeds with content filtering and persistent storage
+ 
 ## 📦 Installation
 
 ### Quick Install
@@ -128,6 +129,7 @@ Below is a comprehensive table of all available tools, how to use them with an a
 | workflow | `agent.tool.workflow(action="create", name="data_pipeline", steps=[{"tool": "file_read"}, {"tool": "python_repl"}])` | Define, execute, and manage multi-step automated workflows |
 | batch| `agent.tool.batch(invocations=[{"name": "current_time", "arguments": {"timezone": "Europe/London"}}, {"name": "stop", "arguments": {}}])` | Call multiple other tools in parallel. |
 | browser | `browser = LocalChromiumBrowser(); agent = Agent(tools=[browser.browser])` | Web scraping, automated testing, form filling, web automation tasks |
+| rss | `agent.tool.rss(action="subscribe", url="https://example.com/feed.xml", feed_id="tech_news")` | Manage RSS feeds: subscribe, fetch, read, search, and update content from various sources |
 
 \* *These tools do not work on windows*
 
@@ -450,6 +452,46 @@ response = agent("discover available agents and send a greeting message")
 # - send_message(message_text, target_agent_url) to communicate
 ```
 
+### RSS Feed Management
+
+```python
+from strands import Agent
+from strands_tools import rss
+
+agent = Agent(tools=[rss])
+
+# Subscribe to a feed
+result = agent.tool.rss(
+    action="subscribe",
+    url="https://news.example.com/rss/technology"
+)
+
+# List all subscribed feeds
+feeds = agent.tool.rss(action="list")
+
+# Read entries from a specific feed
+entries = agent.tool.rss(
+    action="read",
+    feed_id="news_example_com_technology",
+    max_entries=5,
+    include_content=True
+)
+
+# Search across all feeds
+search_results = agent.tool.rss(
+    action="search",
+    query="machine learning",
+    max_entries=10
+)
+
+# Fetch feed content without subscribing
+latest_news = agent.tool.rss(
+    action="fetch",
+    url="https://blog.example.org/feed",
+    max_entries=3
+)
+```
+
 ## 🌍 Environment Variables Configuration
 
 Agents Tools provides extensive customization through environment variables. This allows you to configure tool behavior without modifying code, making it ideal for different environments (development, testing, production).
@@ -605,6 +647,13 @@ The Mem0 Memory Tool supports three different backend configurations:
 | STRANDS_BROWSER_WIDTH | Default width of the browser | 1280 |
 | STRANDS_BROWSER_HEIGHT | Default height of the browser | 800 |
 
+#### RSS Tool
+
+| Environment Variable | Description | Default |
+|----------------------|-------------|---------|
+| STRANDS_RSS_MAX_ENTRIES | Default setting for maximum number of entries per feed | 100 |
+| STRANDS_RSS_UPDATE_INTERVAL | Default amount of time between updating rss feeds in minutes | 60 |
+| STRANDS_RSS_STORAGE_PATH | Default storage path where rss feeds are stored locally | ~/.strands/rss_feeds |
 
 ## Contributing ❤️
 

pyproject.toml

@@ -91,9 +91,10 @@ agent_core_code_interpreter = [
     "bedrock-agentcore==0.1.0"
 ]
 a2a_client = ["a2a-sdk[sql]>=0.2.11"]
+rss = ["feedparser>=6.0.10,<7.0.0", "html2text>=2020.1.16,<2021.0.0"]
 
 [tool.hatch.envs.hatch-static-analysis]
-features = ["mem0_memory", "local_chromium_browser", "agent_core_browser", "agent_core_code_interpreter", "a2a_client"]
+features = ["mem0_memory", "local_chromium_browser", "agent_core_browser", "agent_core_code_interpreter", "a2a_client", "rss"]
 dependencies = [
     "strands-agents>=1.0.0",
     "mypy>=0.981,<1.0.0",
@@ -112,7 +113,7 @@ lint-check = [
 lint-fix = ["ruff check --fix"]
 
 [tool.hatch.envs.hatch-test]
-features = ["mem0_memory", "local_chromium_browser",  "agent_core_browser", "agent_core_code_interpreter", "a2a_client"]
+features = ["mem0_memory", "local_chromium_browser",  "agent_core_browser", "agent_core_code_interpreter", "a2a_client", "rss"]
 extra-dependencies = [
     "moto>=5.1.0,<6.0.0",
     "pytest>=8.0.0,<9.0.0",