RSS フィードを Notion データベースへ送信する Google Apps Script ライブラリー。
MIT License
RSS フィードを Notion データベースへ送信する Google Apps Script ライブラリー。
flowchart LR
feed1[( FEED A )] -- fetch --> f2n
feed2[( FEED B )] -- fetch --> f2n
feed3[( FEED C )] -- fetch --> f2n
subgraph GAS
f2n[[ feed2notion ]]
end
subgraph Notion
f2n -- send -->
db[( DATABASE )]
db --> view1[/ LIST view /]
db --> view2[/ LIST view /]
db --> view3[/ GALLERY view /]
end
ライブラリーは App Script で利用できる状態になっています。 Apps Script のコードエディターで以下の手順を実行するとプロジェクトへ追加できます。
1gLGL4oQse_fv1Mm8VfzxmgKOMKvgz592ME4mQSh7Va4MQGxvR6wxdCNl
を入力し検索をクリックFeedToNotion
へ変更上記以外にも Release ページから gas-feed2notion.zip
をダウンロードし、/dist
ディレクトリーをプロジェクトへコピーできます。
Google Apps Script のスクリプトから RSS フィードを取得し Notion のデータベースへ送信する方法です。
データベースの親になるページを用意します。
Notion 外部からデータベースを操作するためのインテグレーション(API KEY)が必要です。以下を参考に作成してください。
名前は任意ですが後述の通知機能でメンションを行ったユーザーとして表示されます。 機能は以下のように設定します。
以下を参考に用意したページをインテグレーションと共有してください(データベースをスクリプトで作成するためにページを共有しています)。
このリポジトリをローカルへ clone 後、以下のようにスクリプトを実行することで作成できます。
ここで表示される user_id
と database_id
は後の設定で利用します。
なお、実行には jq
が必要です。
$ export NOTION_API_KEY="<API KEY>"
$ export PARENT_PAGE_ID="データベースを作成するページのID"
$ export DATABASE_NAME="作成するデータベースの名前"
$ bash scripts/create_database.sh
user_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
database_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
手動で作成する場合は以下のプロパティ定義が必要です。
プロパティ名 | プロパティの種類 |
---|---|
tags |
マルチセレクト |
pubDate |
日付 |
link |
URL |
既読 |
チェックボックス |
description |
テキスト |
guid |
テキスト |
スタンドアロンのスクリプトを作成し、以下の手順を実行してください。
notion_api_key
database_id
を追加settings_()
の opts.feeds
配列にフィード情報を記述しますfeed2notion
を関数を実行する
function settings_() {
const props = PropertiesService.getScriptProperties()
const apiKey = props.getProperty('notion_api_key')
const database_id = props.getProperty('database_id')
const opts = {
database_id,
feeds: [{ name: 'feed name', url: 'feed url' }],
limit: 10
}
return {
apiKey,
opts
}
}
function feed2notion() {
const settings = settings_()
FeedToNotion.send(settings.apiKey, settings.opts)
}
しばらく待つと Notion のデータベースにフィードの情報が追加されます。
追加されない場合は以下のような原因が考えられます。
フィードに画像が登録されてれいない場合、各ページ og:image の URL を取得しています。以下のようにコードを変更することで無効化できます。
function settings_() {
const props = PropertiesService.getScriptProperties()
const apiKey = props.getProperty('notion_api_key')
const database_id = props.getProperty('database_id')
const opts = {
database_id,
feedTransfomers: [],
feeds: [{ name: 'feed name', url: 'feed url' }],
limit: 10
}
return {
apiKey,
opts
}
}
function feed2notion() {
const settings = settings_()
FeedToNotion.send(settings.apiKey, settings.opts)
}
以下のようにコードを変更することで「フィード内に指定されたキーワードが存在していたらメンションを行う」設定をできます。 結果としてメンションが行われたと通知されるようになります。
notify_user_id
を追加
user_id
を指定できますfunction settings_() {
const props = PropertiesService.getScriptProperties()
const apiKey = props.getProperty('notion_api_key')
const database_id = props.getProperty('database_id')
const notify_user_id = props.getProperty('notify_user_id')
const w2m = FeedToNotion.getWordsToMentionParamTeransFormer()(
['keyword1', /keyword2/i],
notify_user_id
)
const opts = {
database_id,
paramTransfomers: [...FeedToNotion.presetParamTransformers(), w2m],
feeds: [{ name: 'feed name', url: 'feed url' }],
limit: 10
}
return {
apiKey,
opts
}
}
function feed2notion() {
const settings = settings_()
FeedToNotion.send(settings.apiKey, settings.opts)
}
Transformer 関数(ジェネレーター関数)を作成することで Notion のデータベースへ追加されるフィードの情報を変更できます。
以下は上記で利用している通知機能を実現する Transformer のソースコードです。
export function getWordsToMentionParamTeransFormer(
words: (string | RegExp)[],
userId: string
): FeedToNotion.ParamTransfomer {
return function* (
ite: Generator<[CreatePageParameters, FeedToNotion.FeedItem, string]>
): Generator<[CreatePageParameters, FeedToNotion.FeedItem, string]> {
for (const [param, item, xmlText] of ite) {
if (
words.some(
(w) =>
item.title.match(w) ||
item.description.match(w) ||
item.feedName.match(w)
)
) {
param.children?.unshift({
object: 'block',
type: 'paragraph',
paragraph: {
rich_text: [
{
type: 'mention',
mention: {
user: {
id: userId
}
}
}
]
}
})
}
yield [param, item, xmlText]
}
}
}
TypeScript(clasp) でコードを記述している場合は、@hankei6km/gas-feed2notion
を import することで型定義を利用できます。
$ npm install --save-dev @hankei6km/gas-feed2notion
MIT License
Copyright (c) 2022 hankei6km