TimeTree の予定を Notion に同期する自動化を、一切課金せず GitHub Actions だけで永久運用できたら嬉しくないですか？
この記事では、公開リポジトリのまま機密ロジックを守りつつ、10 分ごとに走るスクレイピング＆同期基盤を構築するための実践テクニックを紹介します。

ゴール

GitHub Actions（Public リポジトリ枠）を完全無料で回し続ける
公開したくないロジック／認証情報は Secrets への埋め込みだけ で守る
TimeTree から取得した予定を Notion データベースへ同期し、画像も添付する

リポジトリのURL

https://github.com/epoch0718/py_timetree_scraper.git
git cloneしても使えません。　（笑）

仕組みの全体像

公開リポジトリ にメインスクリプト (timetree_notion_week.py) とワークフロー (.github/workflows/main.yml) を置く
スクレイピングのコア部分 (private_scraper.py) と .env はリポジトリから分離
GitHub Actions の Secrets に PRIVATE_SCRAPER / ENV_FILE として全文を保存
ワークフロー起動時に Secrets からファイルを書き戻し → スクリプトを実行
TimeTree からイベントを取り込み、非同期で Notion API へ同期

ポイント：公開リポジトリでも「重要ロジックは置いていない」ので、悪用される心配がありません。

フォルダ構成（公開側）

py_timetree_scraper/
├─ .github/
│   └─ workflows/
│       └─ main.yml        # GitHub Actions 定義
├─ timetree_notion_week.py # メインスクリプト（スクレイピング関数は外部 import）
├─ requirements.txt
├─ README.md
└─ .gitignore              # private_scraper.py / .env を除外

秘密ファイルの扱い

private_scraper.py … スクレイピングロジックを丸ごと格納（公開しない）
.env … TimeTree/Notion の認証情報

どちらも .gitignore に追加し、レポジトリには存在しません。

GitHub Actions ワークフロー（核心部分）

# .github/workflows/main.yml の抜粋 (10分刻みで自動実行)
on:
  schedule:
    - cron: "*/10 * * * *"
  workflow_dispatch:

jobs:
  scrape-and-update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - run: pip install -r requirements.txt

      - name: Restore .env from secret
        run: |
          printf '%s' "$ENV_FILE" > .env
        env:
          ENV_FILE: ${{ secrets.ENV_FILE }}

      - name: Restore private scraper
        run: |
          printf '%s' "$PRIVATE_SCRAPER" > private_scraper.py
        env:
          PRIVATE_SCRAPER: ${{ secrets.PRIVATE_SCRAPER }}

      - run: python timetree_notion_week.py

なぜこれで機密が守られる？

公開リポジトリ側には機密ロジックを一切置いていない
GitHub Actions が起動する瞬間だけ Secrets からファイルを復元し、処理終了後には runner が破棄される
誰かがリポジトリをクローンしても、肝心の private_scraper.py が無いのでスクレイピングはできない

Secrets 登録手順（ENV_FILE / PRIVATE_SCRAPER）

.env、private_scraper.py の内容をコピー
GitHub のリポジトリ設定 → Settings > Secrets and variables > Actions
New repository secret で以下を登録

名前	内容
`ENV_FILE`	`.env` の全文（改行込み）
`PRIVATE_SCRAPER`	`private_scraper.py` の全文

貼り付けるだけで OK。Base64 変換などは不要です。

ローカル開発との両立

private_scraper.py と .env をローカルのプロジェクト直下に配置
python timetree_notion_week.py を実行するだけで動作
万が一ファイルを消してしまっても、非公開バックアップリポジトリ（例: py_timetree_scraper_private_scraper）へ push しておけば、すぐ復元可能

バックアップリポジトリは Private にして、アクセス権限を最小化するのがコツ。

この構成のメリット

永遠に無料
公開リポジトリは GitHub Actions の無料枠が潤沢。cron で 10 分ごとに回しても課金の心配なし。
スクレイピングロジックを秘匿
private_scraper.py が無いと TimeTree の DOM セレクタや除外ルールはわからない＝悪用されない。
Secrets 一括管理
.env も含めて Secrets に突っ込んでおけるので、環境差分がなく再現性も高い。
Playwright + 非同期 Notion API
画像添付や TimeTreeID ベースの差分更新など、実用的な同期ロジックをそのまま流用できる。

まとめ

公開リポジトリでも「見せたい部分だけを公開し、核となるロジックは別ファイル＋Secrets」に分離すれば、GitHub Actions を完全無料でフル稼働させつつ、安全に運用できます。
スクレイピングパートを非公開化しているので、リポジトリ自体は「コード全体を見たい人には無意味」＝悪用されない状態をキープできます。

あなたの自動化ワークフローでも、同じ方法で「無料かつ安全」な仕組みを構築してみてください！