← All ivy-agents
IVYXSTUDIO · IVY AGENT
R

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.

  1. 01
    Fetch each feed

    Runs RSS Fetch once for each item of urls from the agent's input.

    For each
  2. 02
    Write the newsletter

    Write a short daily newsletter summarizing the RSS feed items.

    takes
    context from step 1, results
    returns
    newsletter
    Model turn
  3. 03
    Mail the newsletter
    ivy.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
    body from step 2, output.newsletter
    subject from the agent's input
    from_addr from the agent's input, username
    username from the agent's input
    to from the agent's input
    smtp_host from the agent's input
    smtp_port from the agent's input
    use_tls from the agent's input, smtp_tls
    set
    smtp_host smtp.gmail.com
    smtp_port 587
    use_tls true
    subject Daily Newsletter
    secret
    password the stored secret mail-password
    returns
    sent, recipients
    Ivy Node

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.

Calls a modelmessage-sendNetwork

What it needs

  • A stored secret named mail-password. The agent's file carries the name, never the value.

Inputs

FieldTypeDescription
urlsrequiredarrayThe feed addresses.
usernamerequiredstringThe sending address, which is the login name; its password is the stored secret mail-password.
torequiredstringWhere to send it.
subjectstringThe subject line.
smtp_hoststringThe SMTP server; smtp.gmail.com when left out.
smtp_portintegerThe SMTP port; 587 when left out.
smtp_tlsbooleanUpgrade SMTP with STARTTLS; on when left out.

Outputs

FieldTypeDescription
newsletterstringThe newsletter that was sent.
sentbooleanTrue once the server accepted it.
recipientsarrayWho 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_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    urls ["http://127.0.0.1:18900/tech.xml","http://127.0.0.1:18900/biz.xml"]
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    sent equals true
    recipients equals ["agent@ivyx.test"]
    newsletter matches [Pp]ython
  • one-feed

    One feed alone makes a newsletter about its own items.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    urls ["http://127.0.0.1:18900/biz.xml"]
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    sent equals true
    newsletter matches [Rr]etail|[Rr]ate