何をするか
- Javascript(Node.js)でRSSフィードを取得する。
- その後SendgridのAPIを使用して、取得したRSSフィードの一覧をメールで送信する。
- 上記のコードをGithub Actionsで1日1回実行し、自動取得・自動メール送信を実現する。
メモ程度に書き殴るので情報量は少なめ..御了承を
ちなみにメール送信はGmailでNodemailerをはじめは使用していたが、Gmail側のセキュリティ設定ではローカルではうまく動くもののGithub Actions上ではうまくいかない(OAuth2を設定すればうまくいく？かもしれないが今回は手軽にしたかった)ため断念
開発環境
- macOS :Monterey12.4 (M1)
- Node.js : 16.15
- npm : 8.5.5
- sendgrid-nodejs : 7.7.0
- nodemailer : 6.7.5
- rss-parser : 3.12.0
RSSフィードを取得
RSSの取得にはrss-parserを使う。公式によると、以下のように使うらしい。
そういうわけで、parser.parseURL('https://www.reddit.com/.rss')のURLを自身の好きなRSSフィードのURLにすればデータが取得できる。
let Parser = require('rss-parser');
let parser = new Parser();
(async () => {
let feed = await parser.parseURL('https://www.reddit.com/.rss');
console.log(feed.title);
feed.items.forEach(item => {
console.log(item.title + ':' + item.link)
});
})();
また、実行結果はこのように出力される。
feedUrl: 'https://www.reddit.com/.rss'
title: 'reddit: the front page of the internet'
description: ""
link: 'https://www.reddit.com/'
items:
- title: 'The water is too deep, so he improvises'
link: 'https://www.reddit.com/r/funny/comments/3skxqc/the_water_is_too_deep_so_he_improvises/'
pubDate: 'Thu, 12 Nov 2015 21:16:39 +0000'
creator: "John Doe"
content: '<a href="http://example.com">this is a link</a> & <b>this is bold text</b>'
contentSnippet: 'this is a link & this is bold text'
guid: 'https://www.reddit.com/r/funny/comments/3skxqc/the_water_is_too_deep_so_he_improvises/'
categories:
- funny
isoDate: '2015-11-12T21:16:39.000Z'
今回は、とりあえずtitle link pubDateの一覧をメールで送信することとする。
取得したデータをメールで送信(Sendgrid API 使用)
SendgridのAPIを使用する。使用には登録が必要なので注意!
ここを参考に登録後APIキーを発行するのだが、APIキーはメール送信時に使用するため覚えておく。
公式のブログを参考にコードを書く。
以下の部分のtext html部分に先ほど取得したRSSフィードの一覧を入れれば、メッセージにRSSフィードの一覧が表示される。
subject: '[sendgrid-nodejs-example] フクロウの名前は%fullname%さん', // 件名
text: '%familyname%さんは何をしていますか？\n彼は%place%にいます', // textパート
html: '<strong>%familyname%さんは何をしていますか？</strong><br>彼は%place%にいます。', // htmlパート
substitutionWrappers: ['%', '%'], // 置換タグの指定
そのため、たとえば以下のようにhtmlでRSSの一覧をリスト整形して入れれば、リストで整然としたメッセージを送信できる。
<ul>
<li> <a href='${items.link1}'> ${items.title1} </a>: ${items.pubDate1} </li>
<li> <a href='${items.link2}'> ${items.title2} </a>: ${items.pubDate2} </li>
.
.
.
<li> <a href='${items.linkN}'> ${items.titleN} </a>: ${items.pubDateN} </li>
</ul>
ちなみに.envに記入した以下の内容はGithub Actionsを使用するときに必要になるため頭の隅で覚えておく。
API_KEY=api_key
TOS=送信先のメールアドレス複数の場合カンマ区切り
FROM=送信元のメールアドレス
Github Actionsで自動化する
以下を参考に.github/workflowに実行したい任意のyamlファイルを書いていく。
ここで注意することとしてGithub Actionsを無料で使うには、リポジトリをPublicにする必要がある。そのため、APIキーやメールアドレスなどの公開すべきでない情報がソースコードに書いていないかを確認してからpushすることをお勧めします。
yamlファイルの例を以下に示す。
name: rss
on:
schedule:
- cron: '0 0 * * *' #cronで定期実行、例では毎日0時0分に実行される。
jobs:
build:
# Ubuntuの最新版環境内で処理を実行することを指定
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: '16'
- run: npm ci #package-lock.jsonから依存関係のインストール
- run: |
cat <<EOL >> ./.env
API_KEY="${{secrets.API_KEY}}"
FROM="${{secrets.FROM}}"
TOS="${{secrets.TOS}}"
EOL
- run: node main.js #RSS取得とメール送信の処理を書いたファイルを指定
以下の部分では上でやったSendgrid用の.envファイル生成を行う。
- run: |
cat <<EOL >> ./.env
API_KEY="${{secrets.API_KEY}}"
FROM="${{secrets.FROM}}"
TOS="${{secrets.TOS}}"
EOL
${{secrets.API_KEY}} ${{secrets.FROM}} {{secrets.TOS}}はGithub ActionsのsecretsでAPIキーなどを呼び出している。
secretsを参考に.envの内容を登録することで、安全にAPIキーなどを使用することが可能となる。
あとは待つだけ
以上でRSSを自動取得し1日1回メール配信を行えるようになりました！
終わりに
土台は作れたので徐々に良くしていければと思う次第です。
一応、稚拙ですがソースは以下にあります。参考になれば幸いです。
https://github.com/cacaoMath/windows_news_collector
まだ学び始めもあり、間違いなどありましたらご指摘・コメントなどいただけると嬉しいです！
ありがとう御座いました！
参考文献
-
RSS取得関連
-
Sendgridでのメール送信
-
Github Actions関連
-
その他
- 定期実効する際のcronの設定