Power Automate クラウドフローで Bing Custom Search APIを利用してWeb検索を行う 💎

サブスクリプション
- あらかじめ作成しておく必要があります
リソースグループ
- 複数のリソースをまとめて管理するためのグループです。作成済みのリソースグループがある場合は選択し、ない場合はこのページから新規作成もできます。
名前
- Bing カスタム検索リソースの名前を付けます
リージョン
- グローバルのまま変更不要
価格レベル
- Bing Custom Search APIは従量課金制です。
  - https://www.microsoft.com/en-us/bing/apis/pricing
- F1を選択すれば無料枠で試すことができます。

全て設定したら契約条件に同意するチェックをオンにし「確認と作成」をクリックします。

3.選択した内容を確認し問題なければ「作成」をクリックするとリソースが作成され舞す

4.作成が完了したらリソースに移動します

5.作成したBing カスタム検索リソースを開くとこんな画面が表示されます

ページ中央「お試しください」の下で実際に検索を試すことができますが、試すには準備作業2でカスタム設定を作成する必要があります。

6.画面中央右のキーの管理の「click here to manage keys 」をクリックします

7.Key1の右端のアイコンをクリックしAPIキーをクリップボードにコピーします

コピーしたキーは安全な場所に保管しておきます。

以上で、Azure Portalでの準備作業は完了です。

準備作業2-Bing Custom Search のカスタム設定を作成する

Bing Custom Search の検索条件を指定するカスタム設定を作成していきます。

1.Bing Custom Search にアクセス

https://www.customsearch.ai/

2.「Get Started」ボタンをクリック

Microsoftのサインインページに移動しますので、

個人向けのMicrosoftアカウント・法人向けの組織または学校アカウントどちらかでサインインします。

3.利用条件を確認し同意できる場合はチェックし「Agree」をクリック

4.Welcomeな表示を確認して閉じます

ここからは表示の順に進めていきます。

5.「Create New Instance」をクリック

6.インスタンス（=カスタム設定）の作成

作成するカスタム検索のインスタンス名（カスタム設定の名称）を設定します。今回は道の駅の情報を検索する設定を作ってみますので「MichinoEKi」という名前を入力しOKをクリックします。

作成が完了すると、インスタンスの設定画面が表示されます。

6-1.検索対象のサイトを設定

表示されたページで検索対象のページを設定します。

今回は下記2つのサイトを設定します。

道の駅公式ホームページ全国「道の駅」連絡会
- https://www.michi-no-eki.jp/
中部の「道の駅」｜国土交通省中部地方整備局
- https://www.cbr.mlit.go.jp/michinoeki/

ActiveタブにURLを追加していきます。1つ目はまず中央の赤枠に入力し「Include Subpages」はチェックを入れたままにして＋をクリックすると追加されます。

「Type in a URL」のところに入力して2つ目以降を追加します。

右側の検索プレビューで実際に検索してみることができます。

動作を確認して問題ない場合は「Publish」をクリックしてインスタンスを公開します。

成功したら「Go to production environment」をクリックします

運用環境のページが表示されたら「Custom Configuration ID」の値をコピーして安全な場所に保存しておきます。

このページでも実際に検索を試すことができます。

Azure Portalで作成したBing Custom Search リソースのキーを「Subscription Key」に入力する必要があります。

フロー全体図

フロー解説

1.[Flow button for mobile]フローを手動でトリガーする

テストフローなのでこちらをトリガーにしています。

パラメータ1：検索キーワード
- テキスト

2.[Data Control]作成-BCS-SubscriptionKey

本来は Azure Key Valutを使って安全な状態でキーを管理すべきですが、作成環境の都合で今回は作成アクションにキーを格納しています。

入力
- Bing カスタム検索リソースのサブスクリプションキー

3.[HTTP]HTTP-Bing Web Search API

Bing Custom Search APIを呼びます。

URI
- ```
https://api.bing.microsoft.com/v7.0/custom/search?q=@{encodeUriComponent(triggerBody()['text'])}&customconfig=準備2で用意したカスタム設定Id&mkt=ja-JP
```
- パラメータはqとcustomconfigのみ必須ですが、mkt=ja-JPも指定すると日本向けに望ましい結果となります
- 他にも多数のパラメータが利用できます
  - https://learn.microsoft.com/en-us/bing/search-apis/bing-custom-search/reference/query-parameters
Method
- GET
Headers
- Ocp-Apim-Subscription-Key
  - @{outputs('作成-API_Key')}

「道の駅豊橋」を検索キーワードに入力して実行してみました。

するとこんな感じのjsonで返されます。

こちらのページに応答jsonオブジェクトの説明があります。

learn.microsoft.com

参考にしたページ

learn.microsoft.com

さいごに

使い方は先日投稿したBing Web Search APIとほとんど変わりません。カスタム設定をあらかじめ作成しておくことくらいです。Bing Custom Search を利用すると、指定した単一のサイトだけでなく複数のWebページ、サイトだけから検索することができますので、Power Automate クラウドフローからはこちらの方が利用できるシーンは多いかもしれません。