RSS Newsletter
ivy.agent.rss-newsletter · v1.1.0
ivyx
Fetches each RSS or Atom feed, has a model write a short newsletter from all the items, and mails it.
Steps
In the order the agent's file lists them, each with where its inputs come from and the values the file fixes. A branch or a loop is a step too.
- 01For eachFetch each feed
Runs RSS Fetch once for each item of urls from the agent's input.
- 02Model turnWrite the newsletter
Write a short daily newsletter summarizing the RSS feed items.
- takes
contextfrom step 1,results- returns
newsletter
- 03Ivy NodeMail the newsletterivy.node.email-send
Sends a plain-text or HTML email through an SMTP server in one step and returns the recipients it went to.
- takes
bodyfrom step 2,output.newslettersubjectfrom the agent's inputfrom_addrfrom the agent's input,usernameusernamefrom the agent's inputtofrom the agent's inputsmtp_hostfrom the agent's inputsmtp_portfrom the agent's inputuse_tlsfrom the agent's input,smtp_tls- set
smtp_hostsmtp.gmail.comsmtp_port587use_tlstruesubjectDaily Newsletter- secret
passwordthe stored secret mail-password- returns
sent,recipients
Nodes it brings
Adding this agent in IVYX Studio adds these nodes with it. A node your workspace already has is kept as it is, even at another version.
What it touches
Collected from what each of its nodes declares and what the agent's own file declares, such as moving a robot, plus the model call when a step is a model turn. A declaration is the author's statement, and it is what policy rules select on.
What it needs
- A stored secret named
mail-password. The agent's file carries the name, never the value.
Inputs
| Field | Type | Description |
|---|---|---|
| urlsrequired | array | The feed addresses. |
| usernamerequired | string | The sending address, which is the login name; its password is the stored secret mail-password. |
| torequired | string | Where to send it. |
| subject | string | The subject line. |
| smtp_host | string | The SMTP server; smtp.gmail.com when left out. |
| smtp_port | integer | The SMTP port; 587 when left out. |
| smtp_tls | boolean | Upgrade SMTP with STARTTLS; on when left out. |
Outputs
| Field | Type | Description |
|---|---|---|
| newsletter | string | The newsletter that was sent. |
| sent | boolean | True once the server accepted it. |
| recipients | array | Who received it. |
Tests
2 of 2 test cases passed on Oct 7, 2026, in the publisher's own environment, before this version was published. The registry keeps that record; it does not run the cases again.
Requires: python:3.9, a model core, an SMTP server (Gmail unless smtp_host says otherwise) with the sending account's password stored as the secret mail-password, for the cases, GreenMail on 127.0.0.1:3025 (mkdata-mail.py), the test pages served on 127.0.0.1:18900 (python3 -m http.server in data/site)
- two-feeds
Both feeds are fetched and the newsletter is mailed.
- given
smtp_host127.0.0.1smtp_port3025smtp_tlsfalseurls["http://127.0.0.1:18900/tech.xml","http://127.0.0.1:18900/biz.xml"]usernameagent@ivyx.testtoagent@ivyx.test- expects
sentequals truerecipientsequals ["agent@ivyx.test"]newslettermatches [Pp]ython
- one-feed
One feed alone makes a newsletter about its own items.
- given
smtp_host127.0.0.1smtp_port3025smtp_tlsfalseurls["http://127.0.0.1:18900/biz.xml"]usernameagent@ivyx.testtoagent@ivyx.test- expects
sentequals truenewslettermatches [Rr]etail|[Rr]ate