メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

コンテンツクリエイターや音楽レーベルは、Spotify・YouTube・Apple Music など複数のプラットフォームからアナリティクスを集約する必要があります。各プラットフォームのダッシュボードはレイアウトもエクスポート形式も異なり、手動でのログイン・ダウンロードは手間がかかりミスも発生します。 Refrain はこのフロー全体を自動化します。ログインしてアナリティクスページに移動し、日付フィルタを適用してデータをエクスポートします。

​
手順書の例

name: streaming-analytics-export
url: https://analytics.example-music.com/login
variables:
  - name: username
    source: secrets
  - name: password
    source: secrets
  - name: date_range
    source: fixed
    value: "last-30-days"
steps:
  - action: input
    selector: "#email"
    value: "{{ username }}"
  - action: input
    selector: "#password"
    value: "{{ password }}"
  - action: click
    selector: "#signIn"
  - action: wait
    selector: ".dashboard"
  - action: click
    selector: "[data-range='{{ date_range }}']"
  - action: wait
    timeout: 2000
  - action: download
    selector: ".export-csv-button"

​
生成と実行

1

手順書を生成する

npx @refrainai/cli generate -- \
  --url https://analytics.example-music.com/login \
  --goal "ログインして過去 30 日間を選択し、アナリティクス CSV をダウンロードする" \
  --context ./context.md \
  --output ./streaming-report.yaml
2

実行してダウンロードする

npx @refrainai/cli execute -- \
  --runbook ./streaming-report.yaml \
  --secrets ./secrets.json \
  --output-dir ./reports
3

複数プラットフォームを統合する

各プラットフォームの手順書を個別に実行し、--merge-downloads で CSV を統合します：
npx @refrainai/cli execute -- \
  --runbook ./youtube-report.yaml \
  --output-dir ./reports \
  --merge-downloads

​
Refrain が向いている理由

  • マルチプラットフォーム — プラットフォームごとに手順書を作成し、スケジュール実行。
  • ダウンロード管理 — エクスポートファイルを自動でダウンロード・整理。
  • 再実行コストゼロ — 月次レポート収集も AI トークン不要。
  • 自己修復 — ダッシュボードのリニューアルにも自動対応。

​
次のステップ

手順書を実行する

ダウンロードとファイルエクスポートのオプションを学ぶ。

変数とシークレット

複数プラットフォームの認証情報を管理する。