短縮 URL を API で活用する方法：一括作成と自動化の基本
短縮 URL を 1 件ずつ画面から作る方法は、数が少ないうちは問題ありません。ところが、商品ページが数百件ある、毎日の投稿ごとに計測用のリンクが要る、といった状況になると、手作業では追いつきません。そこで役立つのが、プログラムから短縮 URL を作成・管理できる API です。
この記事では、API でできること、自動化の使い道、API キーの安全な扱い方、AI ツールから操作する考え方、Boostlink の API と MCP を説明します。コード例は、考え方を示すための一般的な例です。実際のエンドポイントやパラメーターは、利用するサービスの公式ドキュメントで確認してください。
API で短縮 URL を作るとできること
API は、プログラム同士が決まった形式でやり取りする窓口です。短縮 URL サービスの API では、主に次の操作ができます。
| 操作 | 内容 |
|---|---|
| 作成 | 元の URL を渡して、短縮 URL を発行する |
| 取得 | 作成済みのリンクの情報を取り出す |
| 更新 | 飛び先や設定を変更する |
| 削除 | 不要になったリンクを削除する |
| 集計の取得 | クリック数などのデータを取り出す |
管理画面では 1 件ずつしかできない作業も、API なら繰り返しをプログラムに任せられます。たとえば、表計算ソフトの一覧から 300 件の URL を読み込み、まとめて短縮し、結果を同じ表に書き戻す、といった処理です。基本の作成手順は短縮 URL の作り方で確認できます。
一般的な API は、HTTP リクエストにデータを JSON 形式で載せて送ります。考え方を示すために、次のような例を挙げます。実在する仕様ではありません。
POST https://api.example.com/links
Authorization: Bearer <API キー>
Content-Type: application/json
{ "url": "https://example.com/items/123", "slug": "item-123" }
応答には、発行された短縮 URL が JSON で返ります。プログラムはそれを受け取り、次の処理に渡します。
自動化の使い道
API を使った自動化には、次のような使い道があります。
商品や記事のリンクを一括で作る
EC サイトやブログで、新しい商品や記事を公開するたびに、自動で短縮 URL を発行します。末尾の文字列に商品番号を使えば、管理も整理できます。
投稿ごとに計測用のリンクを作る
SNS の投稿ごとに別々のリンクを発行すれば、どの投稿がクリックされたかを比べられます。投稿の予約ツールと連携させる運用もあります。計測の設計はクリック計測と分析で説明しています。
クリックデータを集めて分析する
API でクリックデータを取り出し、表計算ソフトやダッシュボードに自動で蓄積します。毎週の報告書を手作業で作る手間が減ります。
リンク先をまとめて更新する
商品の入れ替えや、サイトの引っ越しのときに、複数のリンクの飛び先を一括で更新します。リンク先を変えられるかどうかは、サービスごとに違います。注意点はリンク先の変更方法も参照してください。
アプリへのリンクを扱う
スマホアプリへ直接移動させるリンクを大量に発行する場合にも、自動化は有効です。アプリへのリンクの基本も合わせて確認しておくと設計しやすくなります。
API キーの安全な扱い方
API キーは、パスワードと同じように扱う必要があります。キーが漏れると、第三者があなたのアカウントでリンクを作成したり、削除したりできる可能性があります。
守るべき基本は次の 6 つです。
- ソースコードに直接書かない。環境変数や、秘密情報を管理する仕組みに保管する
- GitHub などの公開リポジトリに、キーを含めない
- ブラウザ側のコード（画面に配信される JavaScript）には置かない。キーを使う処理はサーバー側で行う
- 用途ごとにキーを分け、不要になったものは削除する
- 定期的にキーを作り直す。漏れた疑いがあるときはすぐに無効にする
- ログに出力しない。エラー報告に含めない
また、API には利用回数の制限が設けられていることがあります。短時間に大量のリクエストを送ると、一時的に拒否されます。一括処理を作るときは、少し待ってから再試行する仕組みを入れておくと安全です。
AI ツールから操作する方法
近年は、AI のチャットやエージェントから、外部のサービスを直接操作する方法が広がっています。その代表的な仕組みが MCP（Model Context Protocol）です。MCP に対応したサービスは、AI ツールに「できる操作」の一覧を伝えます。利用者が日本語で「この URL を短縮して」と頼むと、AI が必要な操作を選んで実行します。
便利な反面、注意点があります。
- AI に渡す権限は、必要な範囲に絞る。削除などの重要な操作は、実行前に確認を求める設定にする
- 実行結果は、人が目で確認する。特に、大量のリンクを一度に作る場合は、数件を試してから本番に進める
- 取り込まれる文章や外部ページの指示に、AI が従ってしまうリスクがある。見知らぬ文書を読み込ませた状態で、リンクの編集権限を渡さない
Boostlink の API と MCP
Boostlink は、スタンダードとプロの両プランで API と MCP を利用できます。画面から作る短縮リンクを、プログラムや AI ツールから作成・管理する用途に使えます。具体的な使い方や制限は、Boostlink のサイトや管理画面の案内で確認してください。
API キーを発行したら、上で紹介した基本に従って管理します。まずは少数のリンクで試し、結果を確認してから、一括処理に広げるのが安全です。
導入の進め方
API による自動化は、いきなり本番で大規模に動かさず、段階を踏んで進めると安全です。
- 手作業で 1 件作り、期待する結果を確認する
- 同じ内容を API で 1 件作り、手作業の結果と比べる
- 10 件程度でテストし、失敗したときの動作を確認する
- エラー時に再試行する処理と、結果を記録する処理を加える
- 本番の件数に広げる
特に 4 が重要です。通信は失敗することがあり、同じリンクを二重に作ってしまう事故も起こり得ます。作成前に同じ末尾の文字列がないかを調べる、結果を表に記録しておく、といった工夫で防げます。
よくある失敗
- API キーを、共有のスプレッドシートやチャットに貼ってしまう
- テスト用のリンクを、本番のアカウントに大量に作ってしまう
- 失敗した行を記録せず、どこまで処理したか分からなくなる
- 末尾の文字列が重複して、エラーで止まる
どれも、事前に少数で試すことで防げます。リンクの命名ルールは末尾の文字列の決め方も参考にしてください。
まとめ
API を使えば、短縮 URL の作成、更新、集計の取得を自動化でき、数百件のリンクも一度に扱えます。商品ページや投稿ごとのリンク発行、クリックデータの蓄積など、繰り返しの作業に向いています。API キーは、ソースコードやブラウザ側に置かず、環境変数などで管理し、漏れたら無効にします。AI ツールから操作するときは、権限を絞り、結果を人が確認してください。
Boostlink は、API と MCP を両プランに備えた短縮リンクと LP のサービスです。月額 1,000円のスタンダードから、リンク運用の自動化を試せます。発信の母体となるアカウントを早く用意したい場合は、アカウントの購入ができる Boostshop もあります。