Potager反映キット

物件を選び、自分のサイトへすぐ持ち帰る。

Potagerが紹介したい物件を選び、リンク、API、カード用HTML、表示文言を一画面で確認できます。まずは手動で使える形にして、後からWidgetや本番APIへ広げます。

現在のPhase 1では外部Potagerは参加せず、弊社が第一号Potagerとして実運用を検証します。この反映キットは確認用に公開していますが、一般のPotager募集・オンボーディングはPhase 2からです。

物件を選ぶ物件一覧を見る Potager管理画面貼り付け後の見え方

選択中の物件楠の木通りの小さな戸建宮崎市青葉町

反映先サイトことこと通信kotokoto-journal

物件会社青葉まち不動産一般掲載

反映方法Link / APIWidget化前のMVP確認用

公開前チェック

貼る前に、見え方と導線を確認する。

ことこと通信で公開する前に、Potager側で最低限確認する項目です。技術作業が少ない場合でも、この4点だけ見れば運用事故を減らせます。

詳細リンク

物件カードからポタージュ詳細へ移動できるかを確認します。

埋め込み表示

単体カードと一覧ウィジェットが、スマホ幅でも欠けずに表示されるかを見ます。

文脈

記事本文の文脈と、選んだ物件の地域・価格・種別がずれていないかを確認します。

個人情報

問い合わせ者の氏名・電話番号・本文はPotager向けAPIへ返さない前提を保ちます。

反映パック

この物件を、誰かに渡せる状態にまとめる。

選択中の物件と反映先サイトに合わせて、制作担当へ渡すメモを作ります。 WordPress、静的サイト、制作会社への依頼でも、まずこの内容を共有できます。

選択内容

楠の木通りの小さな戸建

地域: 宮崎市青葉町
価格: 3,180万円
反映先: ことこと通信
会社: 青葉まち不動産

詳細導線を確認貼り付け後を見る

共有メモ

制作担当へ渡す最小セット

URL、iframe、一覧iframe、公開前確認をまとめたテキストです。ここをコピーすれば、反映作業の依頼を始められます。

Potage反映パック
物件: 楠の木通りの小さな戸建
地域: 宮崎市青葉町
価格: 3,180万円
反映先: ことこと通信
詳細URL: http://localhost:3100/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal
iframe: http://localhost:3100/embed/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal
一覧iframe: http://localhost:3100/embed/properties?limit=3&site=kotokoto-journal
確認: 詳細リンク、問い合わせ導線、個人情報非表示、記事文脈の4点を公開前に確認

1. 物件を選ぶ

Potagerサイトに載せる物件を決める。

物件詳細から来た場合は、その物件が選択されています。ここで別の物件を選ぶと、下のリンク、API例、カードHTMLが切り替わります。

売買 / 戸建

楠の木通りの小さな戸建

宮崎市青葉町 / 3,180万円

この物件を選ぶ詳細を見る

賃貸 / マンション

青葉町、夕方の光が入るマンション

宮崎市青葉町 / 82,000円/月

この物件を選ぶ詳細を見る

売買 / 戸建

庭の余白を楽しむ平屋

綾町 / 2,480万円

この物件を選ぶ詳細を見る

賃貸 / アパート

本屋の近くの2階の部屋

宮崎市橘通 / 78,000円/月

この物件を選ぶ詳細を見る

売買 / 戸建

油津、港へ続く土間の家

日南市油津 / 1,860万円

この物件を選ぶ詳細を見る

賃貸 / アパート

青島、海風を逃がす白い部屋

宮崎市青島 / 69,000円/月

この物件を選ぶ詳細を見る

売買 / 戸建

都城、台所をひらく古い家

都城市上町 / 2,240万円

この物件を選ぶ詳細を見る

賃貸 / マンション

延岡、夜勤明けの光を受ける部屋

延岡市中川原町 / 64,000円/月

この物件を選ぶ詳細を見る

賃貸 / 戸建

高鍋、朝採れ野菜の近くの平屋

高鍋町北高鍋 / 72,000円/月

この物件を選ぶ詳細を見る

売買 / 戸建

小林、湧水路と小さな離れのある家

小林市細野 / 1,980万円

この物件を選ぶ詳細を見る

売買 / 戸建

西都、自転車で丘へ向かう家

西都市妻町 / 2,360万円

この物件を選ぶ詳細を見る

賃貸 / 戸建

日向、駅と海のあいだの住居兼アトリエ

日向市上町 / 98,000円/月

この物件を選ぶ詳細を見る

2. 反映先を選ぶ

どのPotagerサイトから紹介するかを固定する。

MVPではデモサイトを切り替えます。ここで選んだサイト情報が `site` と `ref` に入り、遷移・問い合わせの成果候補につながります。

API利用可

ことこと通信

宮崎市中心部の暮らしと住まいの文脈を届ける地域メディア。

https://example.com/kotokoto-journalこのサイトで反映

API利用可

ひだまりノート

子育てと散歩の目線で、住まいのまわりを記録する個人サイト。

https://example.com/hidamari-notesこのサイトで反映

API未設定

LOCAL VIEW

地域の景色と物件素材をデザインの視点で再編集するサイト。

https://example.com/local-viewこのサイトで反映

API未設定

まちの便り

都城の日々の声と出来事を、急がず届ける地域の便り。

https://example.com/town-letterこのサイトで反映

API未設定

水辺のノート

宮崎県内の川辺と橋から暮らしを考える読みものサイト。

https://example.com/mizube-noteこのサイトで反映

API利用可

台所の地図帖

食材と人の道筋から、土地の季節を読む個人メディア。

https://example.com/daidokoro-mapこのサイトで反映

API利用可

海風標本室

海辺の風と住まいの小さな工夫を集める観察記録。

https://example.com/sea-breeze-archiveこのサイトで反映

API未設定

夜の灯り採集室

夜道と早朝の安心を、街の灯りから考える記録サイト。

https://example.com/night-light-collectorこのサイトで反映

API利用可

手しごと往来

直す技術と道具が街を巡る様子を伝える地域メディア。

https://example.com/repair-roadこのサイトで反映

API未設定

犬と歩く半径

犬の歩幅で公園、日陰、水場を記録する散歩ノート。

https://example.com/dog-radiusこのサイトで反映

API利用可

余白の農園だより

畑と街のあいだにある時間と関係を伝える農園メディア。

https://example.com/farm-marginこのサイトで反映

API未設定

まちの音図鑑

街の音を短い録音と言葉で残すフィールドノート。

https://example.com/sound-atlasこのサイトで反映

3. 自サイトへ反映

リンク、HTML、APIのどれでも試せる状態にする。

技術のないPotagerはリンクやHTMLから始め、制作会社や開発者がいる場合はAPIで一覧を作れます。問い合わせ者の個人情報はPotager向けAPIには返しません。

プライバシー利用規約

詳細リンク

記事や紹介文からこのURLへ送ると、Potagerサイト経由の導線として扱えます。

http://localhost:3100/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal

遷移を確認

iframe埋め込み

外部サイトへカードごと置きたい場合のMVP用コードです。Potage側の表示をそのまま使えます。

<iframe
  src="http://localhost:3100/embed/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal"
  title="楠の木通りの小さな戸建"
  width="100%"
  height="420"
  style="border:0;max-width:420px;width:100%;"
></iframe>

単体で確認

一覧iframe

Potagerサイトのサイドバーや記事末尾に、公開物件を3件まとめて置くためのMVP用コードです。

<iframe
  src="http://localhost:3100/embed/properties?limit=3&site=kotokoto-journal"
  title="ことこと通信の物件一覧"
  width="100%"
  height="620"
  style="border:0;max-width:520px;width:100%;"
></iframe>

単体で確認

貼り付け確認

Potagerサイト風の記事ページで、単体カードと一覧ウィジェットの見え方を同時に確認できます。

サンプルサイトで確認

カードHTML

WordPressや静的ページに貼るための最小カードです。見た目は自サイト側のCSSで整えます。

<a class="potage-property-card" href="http://localhost:3100/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal">
  <img src="/images/properties/kusunoki-house/exterior.png" alt="楠の木通りの小さな戸建">
  <strong>楠の木通りの小さな戸建</strong>
  <span>宮崎市青葉町 / 3,180万円</span>
</a>

API取得

公開中の有効掲載だけを返します。秘密キーはブラウザへ置かず、 Potagerサイトのサーバーからv1 APIを呼びます。

curl -H 'x-potage-api-key: ptg_demo_kotokoto' \
  'http://localhost:3100/api/v1/properties?site=kotokoto-journal&limit=6'

表示プレビュー

Potage側では、この物件として見える。

Potagerサイト上では見せ方を変えられますが、遷移先はポタージュの詳細ページへ戻します。 SMS確認済み問い合わせまでポタージュ内で追える導線にします。

宮崎市青葉町 / 戸建楠の木通りの小さな戸建

大きな楠のある通りから少し入った、静かな戸建。朝の散歩と近所のパン屋が日常になりそうな住まいです。

3LDK91.2平米宮崎県宮崎市青葉町売買 / 3,180万円青葉まち不動産 / 関連記事 2件一般掲載

iframeプレビュー

Potagerサイトに貼ったときの見え方に近い、小さな埋め込みカードです。

一覧iframeプレビュー

テーマ記事や地域ページの下に置く、複数物件の小さな窓です。

成果の流れ

Potagerの紹介から、SMS確認済み問い合わせへつなぐ。

MVPでは自動請求より先に、Potager流入、SMS確認、不動産会社の確認、運営判定の流れを見える形にします。

1. 流入

Potagerサイトの記事・サイドバー・一覧ウィジェットから、ポタージュ詳細へ移動します。

2. 確認

詳細ページで物件情報を確認し、SMS確認済みの問い合わせへ進みます。

3. 成果候補

不動産会社側で問い合わせを確認し、誠実な問い合わせとして成果候補にします。

4. 判定

不誠実評価がある場合は、運営確認を挟んで報酬対象から外すかを判断します。

開発者向け

APIレスポンスの要点だけ確認する。

開発者は `potageDetailUrl` をリンク先として使えば、反映元サイトを保ったまま詳細へ戻せます。

{
  "apiVersion": "v1",
  "count": 1,
  "pagination": {
    "limit": 6,
    "offset": 0,
    "nextOffset": null
  },
  "properties": [{
    "title": "楠の木通りの小さな戸建",
    "area": "宮崎市青葉町",
    "potageDetailUrl": "http://localhost:3100/properties/kusunoki-house?ref=kotokoto-journal-kusunoki-house&site=kotokoto-journal",
    "thumbnailUrl": "/images/properties/kusunoki-house/exterior.png"
  }]
}