syakesaba

Network/Infrastructure/Data/Security/AI

Github Copilot SDK Pythonを使ってスーパーのチラシ情報を分析する

概要

スーパーのチラシは日本国が誇る最先端のマーケティングツールであり消費者にとって情報の宝庫です。今回はGithub Copilot SDKを使ってスーパーのチラシ情報を分析してみます。Shofoo AIの二番煎じですが、Github Copilot SDK Pythonを使ってみたかったのが主な動機です。それ以外の手段は他の方の記事を見てください。

Warning

本記事執筆時点でGithub Copilot SDKはまだベータ版であり、RPCの安定性やドキュメントの充実度に課題があります

環境構築

Github Copilotの契約

Github Copilot Proプランに加入します。個人利用であれば月額10ドル、企業利用であれば月額19ドルです。加入後、以下のようなghコマンドでGithub Copilot SDK Pythonを使用するための認証トークンを取得できます。

gh auth login
gh auth token

Warning

gh auth tokenはGithubの認証トークンです。絶対に他人に見せないようにしてください。

Googleアカウントの作成

今回は実行環境にGoogle Colabを使用します。Google Colabはghやuvといった開発ツールがプリインストールされておりGithub Copilot SDK Pythonも簡単にインストールできます。Google Colabの利用にはGoogleアカウントが必要です。以下のURLからGoogle Colabにアクセスして、Googleアカウントでログインし、🔑のマークからGH_TOKENという名前でGithubの認証トークン(gho_****)をSecretに登録し、Notebook Accessを有効化してRun allをすれば一通りのGithub Copuilot SDK Pythonの機能を試せます。

Open In Colab

このGoogle Colab環境を引き続き使用します。

Warning

Secretに登録したGH_TOKENはGoogleColab上に文字列として出力しないようにしてください。

チラシ情報の用意

チラシ情報の取得はスクレイピングが必要ですが今回は事前に用意したチラシ情報を使用します。適当に取ってきた以下のチラシ画像を使います。

https://tokubai.co.jp/スーパー玉出/28/leaflets/100637578/print

tamade.png

実装

プロンプトの育成

まずは何がしたいかをプロンプトで定義します。最初にプロンプトを定義することで、AIエージェントを実装する際のKPIになり、精度を高めるきっかけになります。

今回はたかだか一枚のチラシの分析であるので市場価格との比較や他店舗との価格の比較ができません。よって、チラシに記載のものはすべて「買い」の価格帯であることを前提にします。そのうえで、チラシから抜きたい情報を

  • 商品名
  • 商品カテゴリ
  • 商品価格
  • 商品価格日付

とし、システムプロンプトを簡単に定義します。

あなたはスーパーのチラシ情報を分析するAIエージェントです。チラシ画像から、商品名、商品カテゴリ、商品価格、商品価格日付を可能な限り抜き取ります。商品名は、チラシに記載されている商品名をそのまま抜き取ってください。なお、商品名に本数や100gあたり等、数量の記載がある場合もそのまま抜き取ってください。商品カテゴリは、青果、水産、畜産、惣菜、日配品、一般食品、非食品、その他、の8つのカテゴリのいずれかに自動分類してください。商品価格は、税込価格であることを前提にしてください。商品価格日付は、その商品価格が有効な期間を表すもので、開始日と終了日の両方を含む形式で表してください。ただし、商品価格日付がチラシの掲載期間内であることを前提とします。入力されるチラシ画像はAS-ISでOCRで読み取ってください。出力フォーマットは以下のJSON形式でお願いします。

[
  {
    "商品名": "商品名",
    "商品カテゴリ": "商品カテゴリ",
    "商品価格": "商品価格",
    "商品価格日付": "商品価格日付"
  },
  ...
]

ユーザープロンプトを簡単に以下とします。

このチラシ画像を分析し、全ての商品の情報を抜き出してください。no talking, just output the JSON.

すると、AIモデルは以下のような回答を返してきます。

[
  {
    "商品名": "ショートケーキ・ショコラケーキ 2パック",
    "商品カテゴリ": "一般食品",
    "商品価格": "500円 (税込540円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "サラダ油 1本",
    "商品カテゴリ": "一般食品",
    "商品価格": "498円 (税込537円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "コカ・コーラ 1.5L",
    "商品カテゴリ": "一般食品",
    "商品価格": "138円 (税込149円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "スプライト 1.5L",
    "商品カテゴリ": "一般食品",
    "商品価格": "138円 (税込149円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "ペットボトルお茶 500ml",
    "商品カテゴリ": "一般食品",
    "商品価格": "168円 (税込181円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "生鮭切り身 1切れ",
    "商品カテゴリ": "水産",
    "商品価格": "178円 (税込192円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "うなぎ蒲焼 1尾",
    "商品カテゴリ": "水産",
    "商品価格": "1,680円 (税込1,814円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "たこ 1パック",
    "商品カテゴリ": "水産",
    "商品価格": "298円 (税込321円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "豚ロース切り落とし 100g",
    "商品カテゴリ": "畜産",
    "商品価格": "138円 (税込149円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "若鶏唐揚げ 惣菜パック",
    "商品カテゴリ": "惣菜",
    "商品価格": "198円 (税込213円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "惣菜 竜田揚げ",
    "商品カテゴリ": "惣菜",
    "商品価格": "300円 (税込324円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "キャベツ 1玉",
    "商品カテゴリ": "青果",
    "商品価格": "198円 (税込213円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "長ねぎ 1束",
    "商品カテゴリ": "青果",
    "商品価格": "178円 (税込192円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "レモン 1個",
    "商品カテゴリ": "青果",
    "商品価格": "39円 (税込42円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "バナナ 1房",
    "商品カテゴリ": "青果",
    "商品価格": "98円 (税込105円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "トマト 1パック",
    "商品カテゴリ": "青果",
    "商品価格": "198円 (税込213円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "卵 10個",
    "商品カテゴリ": "日配品",
    "商品価格": "178円 (税込192円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "牛乳 1本",
    "商品カテゴリ": "日配品",
    "商品価格": "168円 (税込181円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "ヨーグルト (個別パック)",
    "商品カテゴリ": "日配品",
    "商品価格": "78円 (税込84円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "冷凍餃子",
    "商品カテゴリ": "一般食品",
    "商品価格": "258円 (税込278円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "即席ラーメン 1個",
    "商品カテゴリ": "一般食品",
    "商品価格": "128円 (税込138円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "野菜つめ放題 1袋",
    "商品カテゴリ": "青果",
    "商品価格": "298円 (税込321円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  },
  {
    "商品名": "マカダミアチョコ (特価パック)",
    "商品カテゴリ": "一般食品",
    "商品価格": "200円 (税込216円)",
    "商品価格日付": "2026-05-08～2026-05-14"
  }
]

関連記事