flashdata-dev commited on
Commit
56f3bf3
·
verified ·
1 Parent(s): f051159

Publish google_shopping tool and request guide

Browse files
Files changed (10) hide show
  1. LICENSE +21 -0
  2. README.md +76 -5
  3. app.js +75 -0
  4. example.json +467 -0
  5. index.html +20 -17
  6. input-schema.json +119 -0
  7. requirements.txt +2 -0
  8. style.css +1 -28
  9. task.json +23 -0
  10. tool.py +36 -0
LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ MIT License
2
+
3
+ Copyright (c) 2026 FlashData contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
README.md CHANGED
@@ -1,12 +1,83 @@
1
  ---
2
- title: Google Shopping Shortlist Flashdata
3
- emoji: 📉
4
- colorFrom: pink
5
  colorTo: indigo
6
  sdk: static
 
7
  pinned: false
8
  license: mit
9
- short_description: Google Shopping product shortlist
 
 
 
 
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: "Google Shopping product shortlist"
3
+ emoji: 🔎
4
+ colorFrom: blue
5
  colorTo: indigo
6
  sdk: static
7
+ app_file: index.html
8
  pinned: false
9
  license: mit
10
+ tags:
11
+ - smolagents
12
+ - tool
13
+ - flashdata
14
+ - google-shopping
15
  ---
16
 
17
+ # Google Shopping product shortlist — FlashData
18
+
19
+ Give a purchasing assistant a dated product shortlist. Retrieve product titles, merchant links and displayed prices for a specific query, then compare suitable listings with the buyer's requirements.
20
+
21
+ **Try this task:** Shortlist USB-C monitors for a home office purchasing brief.
22
+
23
+ [FlashData google shopping documentation](https://flashdata.dev/docs/sources/google_shopping?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google-shopping-shortlist-flashdata) · [Create a FlashData account](https://flashdata.dev/signup)
24
+
25
+ ## Run it
26
+
27
+ Open the Space to edit a request and inspect a documentation response sample. The interactive page runs locally in your browser; it does not send a FlashData query or collect an API key. The Python tool runs in your own process.
28
+
29
+ Use Python 3.10 or newer. Install the pinned dependencies:
30
+
31
+ ```sh
32
+ python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"
33
+ ```
34
+
35
+ Create an API key in the FlashData console, fund the required credits, and supply the key in your local environment. Review `tool.py` before enabling remote code execution.
36
+
37
+ ```python
38
+ import getpass
39
+ import os
40
+ from smolagents import load_tool
41
+
42
+ os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
43
+ tool = load_tool("flashdata-dev/google-shopping-shortlist-flashdata", trust_remote_code=True)
44
+ result = tool(**{'gl': 'us', 'num': 10, 'query': '27 inch USB C monitor'})
45
+ print(result)
46
+ ```
47
+
48
+ This is a native smolagents Tool with typed task inputs. Add the loaded tool to your own agent; model choice, prompts and model fees remain under your control. Direct calls above do not need a model.
49
+
50
+ ## Inputs
51
+
52
+ | Parameter | Type | Required / default | Details |
53
+ | --- | --- | --- | --- |
54
+ | `query` | string | Required | Search query, between 1 and 2,000 characters. |
55
+ | `num` | integer | None | Requested result count. minimum=1, maximum=100 |
56
+ | `page` | integer | None | Search result page. minimum=1, maximum=100 |
57
+ | `autocorrect` | boolean | None | Enable spelling autocorrection. |
58
+ | `gl` | string | None | Two-letter country code, for example us. pattern=^[A-Za-z]{2}$ |
59
+ | `hl` | string | None | Interface language code, for example en. pattern=^[A-Za-z0-9-]{1,35}$ |
60
+ | `location` | string | None | Optional geographic search location. |
61
+ | `tbs` | string | None | Optional Google time filter, for example qdr:w. |
62
+
63
+ Optional `None` values are omitted; the documented adapter defaults apply.
64
+
65
+ Full validation rules are in `input-schema.json`.
66
+
67
+ ## Output and next step
68
+
69
+ The useful data is at `results.0.shopping`. Relevant fields: `title`, `source`, `price`, `link`, `rating`.
70
+
71
+ Preserve the query time and merchant URL, then verify availability and final checkout price on the merchant site.
72
+
73
+ The Space includes a recorded documentation example and its original request. It is not a fresh result for the task prompt above. Optional fields may be absent.
74
+
75
+ ## Costs, limits and failures
76
+
77
+ Displayed prices are a search snapshot. Stock, delivery charges, final prices and currency comparability are not guaranteed.
78
+
79
+ The tool is MIT licensed. It is free to install. **FlashData API calls are paid**; installation does not include free data queries. Check current [FlashData pricing](https://flashdata.dev/pricing) and your console balance. Platform, model and customer storage charges are separate. Each search/page is a separate request; Extended Search has its own rate. Downloads are charged by delivered data volume.
80
+
81
+ An uncertain timeout can still represent a charged request. Check Jobs in the FlashData console before trying again; this integration does not automatically retry paid submissions. A 401 means the key was rejected, 402 means insufficient credits, and 429 means a rate or quota limit.
82
+
83
+ [Get started with this FlashData capability](https://flashdata.dev/docs/sources/google_shopping?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google-shopping-shortlist-flashdata)
app.js ADDED
@@ -0,0 +1,75 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ const byId = id => document.getElementById(id);
2
+ const pythonLiteral = value => {
3
+ if (value === null) return 'None';
4
+ if (typeof value === 'boolean') return value ? 'True' : 'False';
5
+ if (Array.isArray(value)) return `[${value.map(pythonLiteral).join(', ')}]`;
6
+ if (typeof value === 'object') return `{${Object.entries(value).map(([k,v]) => `${JSON.stringify(k)}: ${pythonLiteral(v)}`).join(', ')}}`;
7
+ return JSON.stringify(value);
8
+ };
9
+
10
+ const [task, example, schema] = await Promise.all(['task.json','example.json','input-schema.json'].map(async file => {
11
+ const response = await fetch(file);
12
+ if (!response.ok) throw new Error(`Unable to load ${file}`);
13
+ return response.json();
14
+ }));
15
+
16
+ document.title = task.title;
17
+ for (const key of ['title','scenario','task','next','limit']) byId(key).textContent = task[key];
18
+ byId('docs').href = `https://flashdata.dev/docs/sources/${task.source}?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=${task.slug}`;
19
+ byId('source').href = `https://huggingface.co/spaces/${task.repo_id}/blob/main/tool.py`;
20
+ byId('readme').href = `https://huggingface.co/spaces/${task.repo_id}/blob/main/README.md`;
21
+ byId('parameters').value = JSON.stringify(task.input,null,2);
22
+ byId('response').value = JSON.stringify(example.response,null,2);
23
+ byId('sample-request').textContent = JSON.stringify(example.request,null,2);
24
+
25
+ function generate() {
26
+ try {
27
+ const args = JSON.parse(byId('parameters').value);
28
+ if (!args || Array.isArray(args) || typeof args !== 'object') throw new Error('Enter a JSON object.');
29
+ const allowed = task.source === 'youtube_download' ? ['operation','parameters','job_id'] : Object.keys(schema.properties);
30
+ if (Object.keys(args).some(key => !allowed.includes(key))) throw new Error('Use only the documented inputs; keep credentials in your local environment.');
31
+ const code = [
32
+ '# Install: python -m pip install smolagents==1.26.0 langchain-flashdata==0.2.1',
33
+ 'import getpass', 'import os', 'from smolagents import load_tool', '',
34
+ 'os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")',
35
+ ...(task.source === 'youtube_download' && args.operation === 'submit' ? ['os.environ["FLASHDATA_DOWNLOAD_STORAGE"] = getpass.getpass("Customer storage JSON: ")'] : []),
36
+ `tool = load_tool(${JSON.stringify(task.repo_id)}, trust_remote_code=True)`,
37
+ `result = tool(**${pythonLiteral(args)})`, 'print(result)'
38
+ ];
39
+ byId('python').textContent = code.join('\n');
40
+ byId('input-status').textContent = 'Python call generated. The tool validates full parameter constraints before a request.';
41
+ } catch (error) {
42
+ byId('python').textContent = '';
43
+ byId('input-status').textContent = error.message;
44
+ }
45
+ }
46
+
47
+ function inspect() {
48
+ byId('results').replaceChildren();
49
+ try {
50
+ const response = JSON.parse(byId('response').value);
51
+ const selected = task.path.split('.').reduce((value, key) => value?.[key], response);
52
+ if (selected === undefined || selected === null) throw new Error(`No value at ${task.path}. Check the response format; failed or pending requests may have different fields.`);
53
+ const rows = Array.isArray(selected) ? selected : [selected];
54
+ byId('response-status').textContent = `${rows.length} item(s) at ${task.path}. Showing up to 10.`;
55
+ for (const row of rows.slice(0,10)) {
56
+ const card = document.createElement('div'); card.className = 'result';
57
+ const fields = typeof row === 'object' && row !== null ? task.fields.filter(key => Object.hasOwn(row,key)) : [];
58
+ if (!fields.length) { const p=document.createElement('p'); p.className='field'; p.textContent=typeof row === 'string' ? row : JSON.stringify(row); card.append(p); }
59
+ for (const key of fields) {
60
+ const line=document.createElement('p'); line.className='field';
61
+ const label=document.createElement('b'); label.textContent=key+': '; line.append(label);
62
+ const value=row[key];
63
+ if (typeof value === 'string' && /^https?:\/\//.test(value)) {
64
+ const link=document.createElement('a'); link.href=value; link.textContent=value; link.target='_blank'; link.rel='noopener noreferrer'; line.append(link);
65
+ } else line.append(document.createTextNode(typeof value === 'object' ? JSON.stringify(value) : String(value)));
66
+ card.append(line);
67
+ }
68
+ byId('results').append(card);
69
+ }
70
+ } catch (error) { byId('response-status').textContent=error.message; }
71
+ }
72
+
73
+ byId('generate').addEventListener('click',generate);
74
+ byId('inspect').addEventListener('click',inspect);
75
+ generate(); inspect();
example.json ADDED
@@ -0,0 +1,467 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "request": {
3
+ "source": "google_shopping",
4
+ "query": "mechanical keyboard",
5
+ "params": {
6
+ "gl": "us",
7
+ "hl": "en",
8
+ "num": 10,
9
+ "page": 1
10
+ }
11
+ },
12
+ "response": {
13
+ "source": "google_shopping",
14
+ "status": "done",
15
+ "results": [
16
+ {
17
+ "searchParameters": {
18
+ "q": "mechanical keyboard",
19
+ "gl": "us",
20
+ "hl": "en",
21
+ "type": "shopping",
22
+ "num": 40,
23
+ "page": 1,
24
+ "engine": "google"
25
+ },
26
+ "shopping": [
27
+ {
28
+ "title": "Keychron V1 Wired Custom Mechanical Keyboard barebone version 75% layout QMK/via programmable macro with Hot-swappable suppo",
29
+ "source": "Keychron.com",
30
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4646494883927026855,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
31
+ "price": "$69.99",
32
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcTmFH2V5iUcuY9yRuK1-vTVeyU3DJLVq_MomMlGTQnfiyxxBIB9ISDiXNuhtyWOBoDJNM1rCNvc07jUU4l1bilumAMkF8aHZ07__xTWQQw1dPRD8xAGCvk4",
33
+ "rating": 4.8,
34
+ "ratingCount": 336,
35
+ "productId": "4646494883927026855",
36
+ "position": 1
37
+ },
38
+ {
39
+ "title": "Logitech POP Keys Wireless Mechanical Emoji Keyboard",
40
+ "source": "Walmart - EXPO PLANET",
41
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:1372105290382114078,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
42
+ "price": "$73.00",
43
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSyNZxBRz-l_Gn9tT9g-R0DuA_0FR4iJ2WoDCy73Y_i3aUpBIFM1LUmZIrg8gSJj_yGR8_d6CH90jhWGxU7vpOPS7x_ZueAB4AEwuShc98auOj5bG520t-t",
44
+ "rating": 4.7,
45
+ "ratingCount": 1000,
46
+ "productId": "1372105290382114078",
47
+ "position": 2
48
+ },
49
+ {
50
+ "title": "GravaStar Mercury K1 Pro 75% Wireless Mechanical Gaming Keyboard",
51
+ "source": "Gravastar",
52
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13608562084648114567,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
53
+ "price": "$199.95",
54
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR-TQsWbAOG7o1rBDqFMd6jm3jNAaOOF_3e2Jx1cX5at8vhXPbNNkZTw0WuZWVlx0uwbhj6QNniEGukqRQ8leJCa-Wxelxyw6k1BRFKL5LhiRIiwNJ4zjL1CA",
55
+ "rating": 4.7,
56
+ "ratingCount": 493,
57
+ "productId": "13608562084648114567",
58
+ "position": 3
59
+ },
60
+ {
61
+ "title": "Ducky Origin Vintage Double Shot PBT Mechanical Keyboard Cherry MX",
62
+ "source": "Mechanical Keyboards",
63
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5748030470703409769,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
64
+ "price": "$79.00",
65
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcR3MvEHH5hEDMgHfOvxGhEeXTcpBdUp7ye1EoKASuls_-EgvFJp88_OZYnDP8jDV8QNL5suAx6dFjYqtS2ikuSQBwJOrlbeiVuEwk52O1U1OIMPwQnHHvg",
66
+ "rating": 4.8,
67
+ "ratingCount": 92,
68
+ "productId": "5748030470703409769",
69
+ "position": 4
70
+ },
71
+ {
72
+ "title": "Womier DUO87 Mechanical Keyboard \u2013 Detachable Smart Display",
73
+ "source": "Womier Keyboard",
74
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17875978550281416490,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
75
+ "price": "$137.00",
76
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR7iPiHCpJ_te1Mu7OVndFELO-RAkYPt28guxbhUl-Xt8z8Fme9KMhqmZpB5p11wKwvz0OzDl25G5yxCAK0SXx5kDPym_o7j1SIy0oI0UFkosNWWic77EbNgQ",
77
+ "rating": 4.2,
78
+ "ratingCount": 4,
79
+ "productId": "17875978550281416490",
80
+ "position": 5
81
+ },
82
+ {
83
+ "title": "Redragon K686 Wireless Mechanical Keyboard",
84
+ "source": "Redragon",
85
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:15726725006224582620,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
86
+ "price": "$74.99",
87
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQJzhmsDaPvgtLa0aBhuEtFCjThX6HyE28H5ZBzHFjbqdfM0XL1Teb22C3EStFJRgL30XmZhKQ9NGu1qWzOkK3WAnQFQwaMbcf4SBWkQIe00ra64UmxKYDv",
88
+ "rating": 4.8,
89
+ "ratingCount": 274,
90
+ "productId": "15726725006224582620",
91
+ "position": 6
92
+ },
93
+ {
94
+ "title": "RK ROYAL KLUDGE 96% Hot-Swappable",
95
+ "source": "RK Royal Kludge",
96
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:7810425084434324091,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
97
+ "price": "$84.99",
98
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQXcsA8mNsVs1QqrU-f095AkcR4asufSiKuUZ2IYyNJR1GjRT6j1a1ppzkoyJrbzfHGwaKS6Msiui9rQknUptv6YSBBtt96rkzI__3nHSqBLRa_YFCEUAMRtg",
99
+ "rating": 4.8,
100
+ "ratingCount": 2500,
101
+ "productId": "7810425084434324091",
102
+ "position": 7
103
+ },
104
+ {
105
+ "title": "Keychron C2 Pro 8K QMK Wired Custom Mechanical Keyboard",
106
+ "source": "Walmart",
107
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11097985348358538808,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
108
+ "price": "$54.88",
109
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcQC8__1QKAxZ-u1qhy6WgLv-tSffFGv9njl1GxL9nPJ9tl4OP7TE_zFY1czFKrZOWT9qc7HTd8yogde1bFEhWTkpR4_kFHzsyMUzPxT27WGzYOCQtXDPdc5",
110
+ "rating": 4.8,
111
+ "ratingCount": 187,
112
+ "productId": "11097985348358538808",
113
+ "position": 8
114
+ },
115
+ {
116
+ "title": "SteelSeries Apex Pro Gen 3 Gaming Keyboard",
117
+ "source": "Best Buy",
118
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11295917230918573865,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
119
+ "price": "$224.99",
120
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRmS27cBS2Ojl93EyGH0naNYSaS2dAk9iRM2jqWypvTDHOOYt59UBM0FSZqQAZrk5tNp5kgLOA3MfnonGc6UIPfibOAFnv0GArlhT7xNwbe5sT65CMzN1wFAA",
121
+ "rating": 4.8,
122
+ "ratingCount": 405,
123
+ "productId": "11295917230918573865",
124
+ "position": 9
125
+ },
126
+ {
127
+ "title": "Akko MG108B Bun Wonderland Keyboard",
128
+ "source": "Micro Center",
129
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18437200232403210249,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
130
+ "price": "$95.99",
131
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSFovRuJomo7BV9V5hIZPo4s9P2C13fjwPMWiJexc0ho1-fT4h5-9qTI1yaxPM15VVjNmdSeika-Dd0Gx8DH0A6EUgsXvB52g",
132
+ "rating": 4.9,
133
+ "ratingCount": 33,
134
+ "productId": "18437200232403210249",
135
+ "position": 10
136
+ },
137
+ {
138
+ "title": "LOFREE Flow Lite84 Keyboard",
139
+ "source": "Lofree Official",
140
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13699470670831714421,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
141
+ "price": "$99.00",
142
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcShd5tCq5fRvRYOQKIVKxw2QNXHjVqdGa7qcvTqD9xLefdokc_EJRvZkOWvssEsjCozhBOoy61ZHf11aAa45HywVirMm7VHCIdBg6PI3JkS6KH-XxwwgyuRBQ",
143
+ "rating": 4.7,
144
+ "ratingCount": 120,
145
+ "productId": "13699470670831714421",
146
+ "position": 11
147
+ },
148
+ {
149
+ "title": "Aula F75 Pro Knob Side-Printed Mechanical Keyboard",
150
+ "source": "AULA Official Store",
151
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17223130883498045915,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
152
+ "price": "$73.90",
153
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcS-kyHNqVcYU7hN9XwqSaVTc-QEJteJJZ0Q3VHiLPaj9f5InmFeEi7NSxvfbv2CEGcceOgmvCrQjqpm3A1a0H1mH-wwpfTamq3PXo9XFib5RgsHYxExpnzp",
154
+ "rating": 4.9,
155
+ "ratingCount": 443,
156
+ "productId": "17223130883498045915",
157
+ "position": 12
158
+ },
159
+ {
160
+ "title": "GravaStar Mercury K1 Gaming Wireless Keyboard",
161
+ "source": "Gravastar",
162
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17971885565025398011,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
163
+ "price": "$129.95",
164
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRZ4UdtZK0Q-T419AFSrzRIOCP7uu6T0sXLVMajYJlNM-xjjJ_1gTKI53pItneB6E9mjGxHrNUwrz22hSB5vT_ZGcGcf1DpWEx74rM9LuGu",
165
+ "rating": 4.8,
166
+ "ratingCount": 872,
167
+ "productId": "17971885565025398011",
168
+ "position": 13
169
+ },
170
+ {
171
+ "title": "Evoworks Evo80 Aluminum TKL Hotswap Wireless Keyboard Spray-coated Cream / HMX Azure / FR4",
172
+ "source": "Mechanical Keyboards",
173
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12449886256735234372,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
174
+ "price": "$169.99",
175
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSvQkVcxw5FX4KsptWjZQ-u5L4cXl_Vn4VjnP96xn9WTjPzVvB6oJ8DJX6_7zTzkDZo5m-yDCG7XOwhbrE_ihgELrEvlA9faARE9KJoaJsSI1WyDOPRDQ7BIQ",
176
+ "rating": 4.9,
177
+ "ratingCount": 146,
178
+ "productId": "12449886256735234372",
179
+ "position": 14
180
+ },
181
+ {
182
+ "title": "Keychron Q6 HE QMK Wireless Custom Keyboard",
183
+ "source": "Keychron.com",
184
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:7059410624114633005,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
185
+ "price": "$249.99",
186
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcT-47odwzaroSeNthjWzQIqMc0i7s-Ydw2osWOYmhe55jWxvRyPj00mQ054eIwEC0dgxfA_JxTLUFbTLmOE2AXGtHrvkH5IZ0u7BsCEEzfLTxfIlqt15voRfw",
187
+ "rating": 4.6,
188
+ "ratingCount": 26,
189
+ "productId": "7059410624114633005",
190
+ "position": 15
191
+ },
192
+ {
193
+ "title": "Redragon Dragonborn Gaming Keyboard",
194
+ "source": "Target",
195
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18294942990556276862,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
196
+ "price": "$39.99",
197
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQl1_4nxXfyXYhpyjVviZvGzepUh4hD_cDT4Qo_3dl9senykXcBcAMz6m0xWMsJFFImWq7CygXvQSusb2qKKPZ1kzSPrXEB",
198
+ "rating": 4.8,
199
+ "ratingCount": 257,
200
+ "productId": "18294942990556276862",
201
+ "position": 16
202
+ },
203
+ {
204
+ "title": "Razer BlackWidow V4 Pro Mechanical Gaming Keyboard",
205
+ "source": "Razer.com",
206
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:2090868471987316808,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
207
+ "price": "$229.99",
208
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSv0-_HICcUd_kG5NoXVBmgemk7NRsHCug6alxVx0V0yUBgxFvVnjrQTBgb4TF87S42jPTvpn1hCvtvZUFD_DSxxlDCrUrcV6O6QW1QYzj5oVgNGcjXiocevw",
209
+ "rating": 4.9,
210
+ "ratingCount": 113,
211
+ "productId": "2090868471987316808",
212
+ "position": 17
213
+ },
214
+ {
215
+ "title": "HyperX Alloy Origins 65 Gaming Mechanical Keyboard",
216
+ "source": "Walmart - Leos Warehaus Inc",
217
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:10412508201090334370,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
218
+ "price": "$64.99",
219
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTUVOTOgGvW1Xtg03YNlpsguGAzi2HdjOy6sa7XqK1hXLl3VGMp3kf8BTfg_ARBbzf0rb39MxyLyzg-O945NwsjKZKrketspt5vc9hC1TQIum_qSmdsKBjP",
220
+ "rating": 4.8,
221
+ "ratingCount": 676,
222
+ "productId": "10412508201090334370",
223
+ "position": 18
224
+ },
225
+ {
226
+ "title": "ROYAL KLUDGE RK61 60% Gaming Mechanical Keyboard for FPS",
227
+ "source": "RK Royal Kludge",
228
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4840064381012612290,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
229
+ "price": "$54.99",
230
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRoKmrgHscv4CZUXnjOF-8vdcj4QLk3qgrDzxi6mk8c0qVHWnY3MMl8JoVNw_TrI7AG9SQvZZ0PqWGhT_eLc55RIU50n5kADJfQZMqun6m79ix_bttZX5vRmA",
231
+ "rating": 4.5,
232
+ "ratingCount": 1300,
233
+ "productId": "4840064381012612290",
234
+ "position": 19
235
+ },
236
+ {
237
+ "title": "Keychron V1 Ultra 8K Wireless Mechanical Keyboard",
238
+ "source": "Best Buy",
239
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12189697796227231637,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
240
+ "price": "$114.99",
241
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQk5Dkt_4UHtkpTM5VKGksa7MLWUUFlsYa-HPM2bgCOik3yS2uxctau0Uj9WpyacXPo9lL_BFhvIYYbhcDuzv2QpGpY_KghWhMeF53gIURnCjDtVaRGwlsW",
242
+ "rating": 4.7,
243
+ "ratingCount": 35,
244
+ "productId": "12189697796227231637",
245
+ "position": 20
246
+ },
247
+ {
248
+ "title": "Ducky One 3 Matcha Hotswap Double Shot PBT Quack Mechanical Keyboard",
249
+ "source": "Mechanical Keyboards",
250
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:10534862950362891730,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
251
+ "price": "$119.00",
252
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTon4oYntHBIfq4ZKi5cBDgetoxBOUQP41dN4ONCtT6Sq_yuQ6_AAGw56OzcYCSp-bIr6gMcpFdM8RJAx3CsP_fhMb3AluHpBprJAbZtGlnyrr-7s9tesJw",
253
+ "rating": 4.4,
254
+ "ratingCount": 138,
255
+ "productId": "10534862950362891730",
256
+ "position": 21
257
+ },
258
+ {
259
+ "title": "Keychron K2 Wireless Mechanical Keyboard",
260
+ "source": "Keychron.com",
261
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17879833808665300620,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
262
+ "price": "$59.99",
263
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRJj9P-dSI-t_oNJhTVMjmoBYTq3PFfcLEMxrwCrolJi_v-kdUMNiDngeLo75K8GZKy0TdJ_-L3d99z-TycuBqSIW_zpD8-zw6M0McHVoXw_He1Vz4BOdY5",
264
+ "rating": 4.4,
265
+ "ratingCount": 1100,
266
+ "productId": "17879833808665300620",
267
+ "position": 22
268
+ },
269
+ {
270
+ "title": "Logitech G316 X 98 Gaming Keyboard",
271
+ "source": "Logitech G",
272
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18379726873606918593,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
273
+ "price": "$119.99",
274
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSH42apx8AnOxSrsay4yxQNqyzwzbZcSJNH4YBtZkGgRfYAPm6qg9lv6PFq4Zs5L0lioMNEwbimkdTRx4Q1T-rZFAzseFBCIsNhrEaw-tySSNSR4OftxAqtng",
275
+ "rating": 4.6,
276
+ "ratingCount": 23,
277
+ "productId": "18379726873606918593",
278
+ "position": 23
279
+ },
280
+ {
281
+ "title": "Keyboard Lofree Flow",
282
+ "source": "Lofree Official",
283
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11810403505487913553,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
284
+ "price": "$119.00",
285
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcR7jR_e5vJmzP5swTrXWbWef2bPL42T2iayNSqU-1ByNrVIZUOF3SdAxUxR8jkeOpYmtKRrnxIx--w0QGwFqCM3WeZiCGwmU3z8H6kiZyQ5DB1aHrO5uZbSMw",
286
+ "rating": 4.9,
287
+ "ratingCount": 125,
288
+ "productId": "11810403505487913553",
289
+ "position": 24
290
+ },
291
+ {
292
+ "title": "Retro Mechanical Keyboard",
293
+ "source": "7KEYS",
294
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11494752268746712765,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
295
+ "price": "$97.99",
296
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTqHc_Jmubaf61naYvm1xegUbsbRjul5uxUC1vfgx4Lc_v7MsWhM-4BtOuq9yL6duHFM_1453batQ14FqY0XRCQ8J73uR6nUrfS-8dveaH1",
297
+ "productId": "11494752268746712765",
298
+ "position": 25
299
+ },
300
+ {
301
+ "title": "Azio Retro Classic Mechanical Keyboard",
302
+ "source": "AZIO Corporation",
303
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:16971097378531019308,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
304
+ "price": "$199.99",
305
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRjVJ2TMfEX0z5cO-qGpRRcCtGig4NFMYSKGWaEAehtdR6jtjR5_PU1xaihJjdQiRZM9wFNLSy9WaqZmRTLS6wAf4X6QnT9kLzVhkPjL3PlO31EixxJJFBh2Q",
306
+ "rating": 4.6,
307
+ "ratingCount": 114,
308
+ "productId": "16971097378531019308",
309
+ "position": 26
310
+ },
311
+ {
312
+ "title": "Keychron Q1 Ultra 8K Wireless Mechanical Keyboard",
313
+ "source": "Keychron.com",
314
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5344649837165815560,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
315
+ "price": "$229.99",
316
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSAchEW3gEEJ0A80awI9E_9K45mDR99a5T3QMeVOscwxr70hTDEzm25g9ynkBcWTLFIV0g4kj_JNLzdopCCV2jexWfyFZ1TooKgOZ0Kabv-c1EQMXkXTDrK",
317
+ "rating": 4.9,
318
+ "ratingCount": 9,
319
+ "productId": "5344649837165815560",
320
+ "position": 27
321
+ },
322
+ {
323
+ "title": "Gravastar Mercury V75 Pro Gaming Keyboard",
324
+ "source": "Best Buy",
325
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:8177873089576243083,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
326
+ "price": "$239.95",
327
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTTcYILadyJ88aGKjCx8IY2Bcrlvr9Pj1TilR4S4FIYNGGQGk7atpxspBbUbV5hZj1y96lo9u2LY9dKnUxm2M9BwjHk4uZE8_QIcZmuTJY",
328
+ "rating": 4.8,
329
+ "ratingCount": 53,
330
+ "productId": "8177873089576243083",
331
+ "position": 28
332
+ },
333
+ {
334
+ "title": "Evoworks Evo80 Aluminum TKL Hotswap Wireless Keyboard",
335
+ "source": "Mechanical Keyboards",
336
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13253336244308435657,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
337
+ "price": "$169.99",
338
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSbS8Qt7QIAKPV12kZDZHEDGHIDNVPOxXOBFGcabuXjA9S1CqxcGeYArXfaj5JkCH57-KCdNhRB8Ze9P6v0gyr7h28vP1IuDgzahV5kTdn3rcCmDPCMqHpAZA",
339
+ "rating": 4.8,
340
+ "ratingCount": 184,
341
+ "productId": "13253336244308435657",
342
+ "position": 29
343
+ },
344
+ {
345
+ "title": "NuPhy Air75 v3",
346
+ "source": "NUPHY",
347
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13232011580101638860,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
348
+ "price": "$149.95",
349
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSXSuE2QgS_Orh5vNXDLz0Ig1QvgnUZnhVxLcPOFvPGK7P0PPWVGGQEzZax7oSx_aifGwgka_A6LTeMV1guizqYXDdeYVSLdy9mMTDVYjlx01drJKK7jQ",
350
+ "rating": 4.7,
351
+ "ratingCount": 489,
352
+ "productId": "13232011580101638860",
353
+ "position": 30
354
+ },
355
+ {
356
+ "title": "Corsair K100 RGB Mechanical Gaming Keyboard",
357
+ "source": "Connection",
358
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:8949332337056099610,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
359
+ "price": "$391.95",
360
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcTGar80LcLrZgPf5fUfP8AhEK29YwWkpaSXSQDG0WwJ7GzC-2L2eGZlyZbp3f5wk5cjjYBXZT-Q1A3WKGbQK6VJFiOJe3QzxiVeVaysjL9q1DgCgkAo92M-",
361
+ "rating": 4.4,
362
+ "ratingCount": 49,
363
+ "productId": "8949332337056099610",
364
+ "position": 31
365
+ },
366
+ {
367
+ "title": "Keychron Q6 Ultra 8K Wireless RGB Keyboard",
368
+ "source": "Keychron.com",
369
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5451284706787390668,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
370
+ "price": "$239.99",
371
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRuvNzVRvGSlbu5UzMxHNnAFyBNWmhU01ty4QZJahImos_-sejyWAUk5Om1jOFrouVPvJaBEnMQ2HKDRVAbBhancZxuJyplmT2xxnIeiflegpVxuCOPmEXO",
372
+ "rating": 4.6,
373
+ "ratingCount": 8,
374
+ "productId": "5451284706787390668",
375
+ "position": 32
376
+ },
377
+ {
378
+ "title": "Logitech G915 X Wired Mechanical Gaming Keyboard",
379
+ "source": "CDW",
380
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12098348343970192457,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
381
+ "price": "$199.99",
382
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSmWp2ZPnH2E0iKlUEpRg-m6EWItJldw1g6mPKbexPC-BmF3TJQ2ISIHdZfTRB-7xxbNCEbmGmu6gUyCaqpKdOHMOK8AN5S334uuCAZ-Ws",
383
+ "rating": 4.4,
384
+ "ratingCount": 145,
385
+ "productId": "12098348343970192457",
386
+ "position": 33
387
+ },
388
+ {
389
+ "title": "Gravastar Mercury V75 HE Gaming Keyboard",
390
+ "source": "Gravastar",
391
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4273064024988134567,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
392
+ "price": "$169.95",
393
+ "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcS9dZLyOhHs4MMqzd7xd1XAbdPcF7ERKi8OGhj4fvqd3a9nh3ockFbtY9_6fBh2fjnwLEFe9iRdplt0ClKHU-aixJkI-vMp1fSR_tB5QPdRqpsRy914J7xwFw",
394
+ "rating": 4.6,
395
+ "ratingCount": 139,
396
+ "productId": "4273064024988134567",
397
+ "position": 34
398
+ },
399
+ {
400
+ "title": "LUMINKEY Luminkey98 V2 Aluminum Wireless Keyboard",
401
+ "source": "Mechanical Keyboards",
402
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12394711049720633366,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
403
+ "price": "$268.00",
404
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcT4prylIX0SZxZF2EaqnMemG6MEBXLYGIIk57ByYkC-duZBl2G8axwrkia5uZf78wmy0eRHDfxNlsfRzoimM3PVQ-vfV_TtkFAH7uUqiTNwx3bZIfGrGB_Npg",
405
+ "productId": "12394711049720633366",
406
+ "position": 35
407
+ },
408
+ {
409
+ "title": "Magegee Typewriter Mechanical Gaming Keyboard Retro Black Punk Round Keycaps RGB Rainbow Backlit Wired Keyboards for Laptop MAC PC Gamer",
410
+ "source": "Best Buy",
411
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5028287084613668314,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
412
+ "price": "$35.99",
413
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTYo9SaiL6a-oKyaIJ76AdZPWLwvJBOVJiVC9lOpSE2GSHuEtGW4y_bXkt6HcWg5llCCwVPuaLIqzyYGFaphGqZmhlJe16_3lUVBeg1B9cQGekdSAyoQEgTIA",
414
+ "productId": "5028287084613668314",
415
+ "position": 36
416
+ },
417
+ {
418
+ "title": "Keychron Q11 Ultra 8K Wireless Custom Mechanical Keyboard Fully Assembled Knob",
419
+ "source": "Keychron.com",
420
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11985821720110681337,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
421
+ "price": "$239.99",
422
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQA5SFnjw7sWt8R2VeLl0ep8zeF0GFVfNqmnHjoN8vqHqCISWah2dxjvNogTEiWA6SVc4s5NOPjHo-n4OdCej8sx8U_fSLKzuk9x5_1Vl-4M9pzeFf_GP7kOA",
423
+ "rating": 3.4,
424
+ "ratingCount": 12,
425
+ "productId": "11985821720110681337",
426
+ "position": 37
427
+ },
428
+ {
429
+ "title": "GravaStar Mercury K98 Pro Wireless Mechanical Gaming Keyboard",
430
+ "source": "Micro Center",
431
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4603642511690907054,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
432
+ "price": "$259.95",
433
+ "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSKxyO9WY0og_9FsQznsx3gJ5ZQzlBzyoVTbbCjM9cTN7FWsLpbgWACg3QHqGOpSuZBXpEV4-fFvAzztRnJ3wRHJt3HaQFQpXQIF1bPDqmmYYVkr18x8w5Rvg",
434
+ "rating": 4.8,
435
+ "ratingCount": 42,
436
+ "productId": "4603642511690907054",
437
+ "position": 38
438
+ },
439
+ {
440
+ "title": "Redragon K556 RGB LED Mechanical Keyboard",
441
+ "source": "Newegg.com",
442
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:16226565545758173114,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
443
+ "price": "$59.99",
444
+ "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcS7ikFjhBZdQ7nefZ7NgQk4ExorwA_pm9sP_ewfHab40aCtJBFq5JK-IDl2_oGfULl8wO1FO0NobMgWsbdeJKqSWIK_DguzHkhKzcBHgGr9AxQCabmj59xl3A",
445
+ "rating": 4.7,
446
+ "ratingCount": 42,
447
+ "productId": "16226565545758173114",
448
+ "position": 39
449
+ },
450
+ {
451
+ "title": "Varmilo Sword 2-87 White LED TKL Dye Sub PBT Aluminum Mechanical Keyboard",
452
+ "source": "Mechanical Keyboards",
453
+ "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12906304364526863838,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
454
+ "price": "$250.00",
455
+ "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSQxoIDwkIgSrqqFqGsMicrAQFfgu8xXXkuusupH87wV56cjqn7-MMY0ZMBYmORlOTJxbP6Tmlyc-_CzhL7C1ZLCUJ-TPYNySekPZ-1JPB8tlBmSzOGWCAgOQ",
456
+ "productId": "12906304364526863838",
457
+ "position": 40
458
+ }
459
+ ]
460
+ }
461
+ ],
462
+ "usage": {
463
+ "credits": 0.02
464
+ },
465
+ "created_at": "2026-09-16T07:41:40.048Z"
466
+ }
467
+ }
index.html CHANGED
@@ -1,19 +1,22 @@
1
  <!doctype html>
2
- <html>
3
- <head>
4
- <meta charset="utf-8" />
5
- <meta name="viewport" content="width=device-width" />
6
- <title>My static Space</title>
7
- <link rel="stylesheet" href="style.css" />
8
- </head>
9
- <body>
10
- <div class="card">
11
- <h1>Welcome to your static Space!</h1>
12
- <p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
13
- <p>
14
- Also don't forget to check the
15
- <a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
16
- </p>
17
- </div>
18
- </body>
 
 
 
19
  </html>
 
1
  <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width,initial-scale=1">
6
+ <title>FlashData research tool</title>
7
+ <link rel="stylesheet" href="style.css">
8
+ </head>
9
+ <body>
10
+ <main>
11
+ <header><a href="https://flashdata.dev" class="brand">FLASHDATA</a><span>Research tools for AI agents</span></header>
12
+ <section class="intro"><p class="eyebrow">SMOLAGENTS TOOL · PYTHON</p><h1 id="title">Loading tool…</h1><p id="scenario"></p><a id="docs" class="cta">Get an API key and read the docs ↗</a></section>
13
+ <div class="grid">
14
+ <section class="panel"><h2>Build a request</h2><p id="task"></p><label for="parameters">Tool inputs (JSON)</label><textarea id="parameters" spellcheck="false"></textarea><button id="generate" type="button">Generate Python call</button><p id="input-status" role="status"></p><pre><code id="python"></code></pre><p class="hint">Run this code in your Python environment. Your API key is entered there, not on this page.</p></section>
15
+ <section class="panel"><h2>Inspect the response</h2><p class="hint">This is a recorded documentation sample, not a live response to the request on the left. You can paste your own response JSON to explore its fields.</p><details><summary>Original sample request</summary><pre id="sample-request"></pre></details><label for="response">Response JSON</label><textarea id="response" spellcheck="false"></textarea><button id="inspect" type="button">Inspect results</button><p id="response-status" role="status"></p><div id="results"></div></section>
16
+ </div>
17
+ <section class="panel next"><h2>Use the result</h2><p id="next"></p><h3>Limits and costs</h3><p id="limit"></p><p>The tool is free to install. <strong>FlashData API calls are paid.</strong> Platform, model and customer storage costs are separate. No API or model call is made by this page. <a href="https://flashdata.dev/pricing">Check pricing ↗</a></p><p>For an uncertain timeout, check Jobs before retrying a paid submission. Download jobs must be read with their saved ID; do not submit again while pending.</p></section>
18
+ <footer><a id="source">Review tool.py</a><a id="readme">Installation and input reference</a><span>MIT licensed integration · FlashData API terms apply separately</span></footer>
19
+ </main>
20
+ <script type="module" src="app.js"></script>
21
+ </body>
22
  </html>
input-schema.json ADDED
@@ -0,0 +1,119 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "additionalProperties": false,
3
+ "description": "Google source parameters; omitted settings use provider behavior.",
4
+ "properties": {
5
+ "query": {
6
+ "description": "Search query, between 1 and 2,000 characters.",
7
+ "maxLength": 2000,
8
+ "minLength": 1,
9
+ "title": "Query",
10
+ "type": "string"
11
+ },
12
+ "num": {
13
+ "anyOf": [
14
+ {
15
+ "maximum": 100,
16
+ "minimum": 1,
17
+ "type": "integer"
18
+ },
19
+ {
20
+ "type": "null"
21
+ }
22
+ ],
23
+ "default": null,
24
+ "description": "Requested result count.",
25
+ "title": "Num"
26
+ },
27
+ "page": {
28
+ "anyOf": [
29
+ {
30
+ "maximum": 100,
31
+ "minimum": 1,
32
+ "type": "integer"
33
+ },
34
+ {
35
+ "type": "null"
36
+ }
37
+ ],
38
+ "default": null,
39
+ "description": "Search result page.",
40
+ "title": "Page"
41
+ },
42
+ "autocorrect": {
43
+ "anyOf": [
44
+ {
45
+ "type": "boolean"
46
+ },
47
+ {
48
+ "type": "null"
49
+ }
50
+ ],
51
+ "default": null,
52
+ "description": "Enable spelling autocorrection.",
53
+ "title": "Autocorrect"
54
+ },
55
+ "gl": {
56
+ "anyOf": [
57
+ {
58
+ "pattern": "^[A-Za-z]{2}$",
59
+ "type": "string"
60
+ },
61
+ {
62
+ "type": "null"
63
+ }
64
+ ],
65
+ "default": null,
66
+ "description": "Two-letter country code, for example us.",
67
+ "title": "Gl"
68
+ },
69
+ "hl": {
70
+ "anyOf": [
71
+ {
72
+ "pattern": "^[A-Za-z0-9-]{1,35}$",
73
+ "type": "string"
74
+ },
75
+ {
76
+ "type": "null"
77
+ }
78
+ ],
79
+ "default": null,
80
+ "description": "Interface language code, for example en.",
81
+ "title": "Hl"
82
+ },
83
+ "location": {
84
+ "anyOf": [
85
+ {
86
+ "maxLength": 200,
87
+ "minLength": 1,
88
+ "type": "string"
89
+ },
90
+ {
91
+ "type": "null"
92
+ }
93
+ ],
94
+ "default": null,
95
+ "description": "Optional geographic search location.",
96
+ "title": "Location"
97
+ },
98
+ "tbs": {
99
+ "anyOf": [
100
+ {
101
+ "maxLength": 200,
102
+ "minLength": 1,
103
+ "type": "string"
104
+ },
105
+ {
106
+ "type": "null"
107
+ }
108
+ ],
109
+ "default": null,
110
+ "description": "Optional Google time filter, for example qdr:w.",
111
+ "title": "Tbs"
112
+ }
113
+ },
114
+ "required": [
115
+ "query"
116
+ ],
117
+ "title": "GoogleInput",
118
+ "type": "object"
119
+ }
requirements.txt ADDED
@@ -0,0 +1,2 @@
 
 
 
1
+ smolagents==1.26.0
2
+ langchain-flashdata==0.2.1
style.css CHANGED
@@ -1,28 +1 @@
1
- body {
2
- padding: 2rem;
3
- font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
4
- }
5
-
6
- h1 {
7
- font-size: 16px;
8
- margin-top: 0;
9
- }
10
-
11
- p {
12
- color: rgb(107, 114, 128);
13
- font-size: 15px;
14
- margin-bottom: 10px;
15
- margin-top: 5px;
16
- }
17
-
18
- .card {
19
- max-width: 620px;
20
- margin: 0 auto;
21
- padding: 16px;
22
- border: 1px solid lightgray;
23
- border-radius: 16px;
24
- }
25
-
26
- .card p:last-child {
27
- margin-bottom: 0;
28
- }
 
1
+ :root{color-scheme:light;font-family:Inter,ui-sans-serif,system-ui,-apple-system,sans-serif;color:#14243b;background:#f4f7fb;font-synthesis:none}*{box-sizing:border-box}body{margin:0}main{max-width:1240px;margin:auto;padding:32px}a{color:#175bc1;text-underline-offset:3px}header{display:flex;align-items:center;gap:24px;border-bottom:1px solid #dce3ed;padding-bottom:24px;color:#64748b;font-size:14px}.brand{font-size:21px;letter-spacing:.1em;font-weight:850;text-decoration:none;color:#123364}.intro{max-width:900px;padding:52px 0 38px}.eyebrow{font-size:12px;letter-spacing:.13em;font-weight:750;color:#4977aa}h1{font-size:clamp(28px,4vw,46px);line-height:1.12;letter-spacing:-.035em;margin:18px 0}h2{font-size:22px;margin:0 0 14px}h3{font-size:17px;margin:28px 0 8px}p{line-height:1.65}.intro>p:not(.eyebrow){font-size:18px;color:#4d6077}.cta{display:inline-block;background:#164f9b;color:white;padding:12px 18px;border-radius:7px;text-decoration:none;font-weight:600;margin-top:12px}.grid{display:grid;grid-template-columns:1fr 1fr;gap:22px}.panel{background:#fff;border:1px solid #dce3ed;border-radius:12px;padding:26px;min-width:0;box-shadow:0 5px 20px #12336405}.hint{color:#61738b;font-size:13px}label{display:block;font-size:13px;font-weight:650;margin:20px 0 8px}textarea{display:block;width:100%;height:190px;resize:vertical;border:1px solid #cbd6e6;border-radius:7px;padding:13px;font:13px/1.55 ui-monospace,SFMono-Regular,monospace;color:#253c58;background:#fbfcff}button{margin-top:12px;border:1px solid #b5c9e4;border-radius:7px;background:#edf4ff;color:#164f9b;padding:10px 15px;cursor:pointer;font:600 14px inherit}button:hover{background:#dfecff}pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#f4f7fb;padding:15px;border-radius:7px;font:12px/1.6 ui-monospace,SFMono-Regular,monospace}details{font-size:13px}summary{cursor:pointer;color:#175bc1}.result{padding:14px 0;border-bottom:1px solid #e5ebf3}.result:first-child{padding-top:0}.field{font-size:13px;line-height:1.6;overflow-wrap:anywhere;margin:4px 0}.field b{color:#62758b;font-weight:500}.next{margin-top:22px}footer{display:flex;flex-wrap:wrap;gap:20px;padding:25px 0;color:#718096;font-size:12px}[role=status]{font-size:13px;color:#536b88}:focus-visible{outline:3px solid #7ea9ee;outline-offset:3px}@media(max-width:800px){main{padding:20px}.grid{grid-template-columns:1fr}.intro{padding-top:30px}header{flex-wrap:wrap;gap:8px}.panel{padding:20px}h1{font-size:32px}}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
task.json ADDED
@@ -0,0 +1,23 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "slug": "google-shopping-shortlist-flashdata",
3
+ "title": "Google Shopping product shortlist \u2014 FlashData",
4
+ "scenario": "Give a purchasing assistant a dated product shortlist. Retrieve product titles, merchant links and displayed prices for a specific query, then compare suitable listings with the buyer's requirements.",
5
+ "task": "Shortlist USB-C monitors for a home office purchasing brief.",
6
+ "input": {
7
+ "query": "27 inch USB C monitor",
8
+ "gl": "us",
9
+ "num": 10
10
+ },
11
+ "path": "results.0.shopping",
12
+ "fields": [
13
+ "title",
14
+ "source",
15
+ "price",
16
+ "link",
17
+ "rating"
18
+ ],
19
+ "next": "Preserve the query time and merchant URL, then verify availability and final checkout price on the merchant site.",
20
+ "limit": "Displayed prices are a search snapshot. Stock, delivery charges, final prices and currency comparability are not guaranteed.",
21
+ "source": "google_shopping",
22
+ "repo_id": "flashdata-dev/google-shopping-shortlist-flashdata"
23
+ }
tool.py ADDED
@@ -0,0 +1,36 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from smolagents import Tool
2
+
3
+
4
+ class FlashDataTool(Tool):
5
+ name = 'google_shopping'
6
+ description = "Give a purchasing assistant a dated product shortlist. Retrieve product titles, merchant links and displayed prices for a specific query, then compare suitable listings with the buyer's requirements. Displayed prices are a search snapshot. Stock, delivery charges, final prices and currency comparability are not guaranteed. Uses paid FlashData API credits. Never automatically retry an uncertain submission; check Jobs first."
7
+ inputs = {'autocorrect': {'description': 'Enable spelling autocorrection. Default: None.',
8
+ 'nullable': True,
9
+ 'type': 'boolean'},
10
+ 'gl': {'description': 'Two-letter country code, for example us. pattern: ^[A-Za-z]{2}$. Default: '
11
+ 'None.',
12
+ 'nullable': True,
13
+ 'type': 'string'},
14
+ 'hl': {'description': 'Interface language code, for example en. pattern: ^[A-Za-z0-9-]{1,35}$. '
15
+ 'Default: None.',
16
+ 'nullable': True,
17
+ 'type': 'string'},
18
+ 'location': {'description': 'Optional geographic search location. Default: None.',
19
+ 'nullable': True,
20
+ 'type': 'string'},
21
+ 'num': {'description': 'Requested result count. minimum: 1. maximum: 100. Default: None.',
22
+ 'nullable': True,
23
+ 'type': 'integer'},
24
+ 'page': {'description': 'Search result page. minimum: 1. maximum: 100. Default: None.',
25
+ 'nullable': True,
26
+ 'type': 'integer'},
27
+ 'query': {'description': 'Search query, between 1 and 2,000 characters.', 'type': 'string'},
28
+ 'tbs': {'description': 'Optional Google time filter, for example qdr:w. Default: None.',
29
+ 'nullable': True,
30
+ 'type': 'string'}}
31
+ output_type = 'object'
32
+
33
+ def forward(self, query: str, num: int | None = None, page: int | None = None, autocorrect: bool | None = None, gl: str | None = None, hl: str | None = None, location: str | None = None, tbs: str | None = None) -> dict:
34
+ from langchain_flashdata import FlashDataGoogleShopping
35
+ values = {'query': query, 'num': num, 'page': page, 'autocorrect': autocorrect, 'gl': gl, 'hl': hl, 'location': location, 'tbs': tbs}
36
+ return FlashDataGoogleShopping().invoke({key: value for key, value in values.items() if value is not None})