AgentQL

AgentQLとは

AgentQLはAI Webスクレイピング向けに作られた。AgentQLクエリ言語は、パーサーとAI層を組み合わせてWebページを読み、操作する。XPathやCSSセレクタを書く代わりに、欲しいフィールドを日常語に近い形で並べる。たとえば products[] { name price } と書けば、その形のJSONが返る。AIが各要素の周辺文脈を読むので、改修でマークアップが動いてもクエリはデータを見つけ出す。

製品は2つの用途をカバーする。データ抽出では query_data が構造化レコードを返す。操作では query_elements と get_by_prompt がPlaywrightのロケーターを渡すので、そのままクリックや入力、スクロールに使える。TinyFishはPythonとJavaScriptのSDK、ブラウザ不要のRESTエンドポイント、クエリを調整するChrome拡張、エージェントフレームワーク向けのMCPサーバーをそろえる。

便利さの代わりに、ホスト型サービスへの依存が付いてくる。クエリはすべてAPIキー付きでAgentQLのAPIを通るため、無料枠を超えれば呼び出しごとに課金され、実行時にはネット接続が要る。canvas主体の画面、珍しいレイアウト、bot対策の厳しいサイトでは失敗することもある。本番では結果を抜き取りで確認したい。

はじめかた

1. agentql.comでアカウントを作り、開発者ポータルでAPIキーをコピーする。
2. pip install agentql か npm install agentql でSDKを入れる。
3. 必要なフィールドを並べたクエリを書く。書式が重要なら price(integer) のような型ヒントを足す。
4. Playwrightスクリプト内で、抽出なら query_data、操作なら query_elements を呼ぶ。
5. playgroundかブラウザ拡張で試してから、規模を広げて実行する。