flashdata-dev commited on
Commit
1a39d5c
·
verified ·
1 Parent(s): 73c91dc

Publish youtube_search_extended tool and request guide

Browse files
Files changed (10) hide show
  1. LICENSE +21 -0
  2. README.md +72 -6
  3. app.js +75 -0
  4. example.json +505 -0
  5. index.html +20 -17
  6. input-schema.json +251 -0
  7. requirements.txt +2 -0
  8. style.css +1 -28
  9. task.json +22 -0
  10. tool.py +23 -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,78 @@
1
  ---
2
- title: Youtube Extended Search Flashdata
3
- emoji: 📉
4
- colorFrom: pink
5
- colorTo: gray
6
  sdk: static
 
7
  pinned: false
8
  license: mit
9
- short_description: YouTube extended research discovery
 
 
 
 
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: "YouTube extended research discovery"
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
+ - youtube-search-extended
15
  ---
16
 
17
+ # YouTube extended research discovery — FlashData
18
+
19
+ Explore a broader set of YouTube videos when a small reading list is insufficient. Request a larger topic sample, retain IDs and source channels, then deduplicate and filter it for your research criteria.
20
+
21
+ **Try this task:** Collect a larger candidate set of battery recycling videos for manual review.
22
+
23
+ [FlashData youtube search extended documentation](https://flashdata.dev/docs/sources/youtube_search_extended?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-extended-search-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/youtube-extended-search-flashdata", trust_remote_code=True)
44
+ result = tool(**{'max_results': 100, 'query': 'battery recycling'})
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 | YouTube search query, between 1 and 2,000 characters. |
55
+ | `max_results` | integer | 20 | Requested result limit, up to 700. minimum=1, maximum=700 |
56
+ | `filters` | object | None | filters |
57
+
58
+ Optional `None` values are omitted; the documented adapter defaults apply.
59
+
60
+ Full validation rules are in `input-schema.json`.
61
+
62
+ ## Output and next step
63
+
64
+ The useful data is at `results.0.results`. Relevant fields: `videoId`, `title`, `channel`, `uploadDate`, `duration`.
65
+
66
+ Use returned IDs to build a review queue. Record the search query and date; the result set is not a complete census of YouTube.
67
+
68
+ 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.
69
+
70
+ ## Costs, limits and failures
71
+
72
+ Up to 700 requested results, default 20; fewer may be available. This is a separate API source with a separate rate, not pagination for standard search.
73
+
74
+ 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.
75
+
76
+ 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.
77
+
78
+ [Get started with this FlashData capability](https://flashdata.dev/docs/sources/youtube_search_extended?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-extended-search-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,505 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "request": {
3
+ "source": "youtube_search_extended",
4
+ "query": "python",
5
+ "params": {
6
+ "max_results": 20
7
+ }
8
+ },
9
+ "response": {
10
+ "source": "youtube_search_extended",
11
+ "status": "done",
12
+ "results": [
13
+ {
14
+ "results": [
15
+ {
16
+ "videoId": "K5KVEU3aaeQ",
17
+ "title": "Python Full Course for Beginners",
18
+ "channel": "Programming with Mosh",
19
+ "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
20
+ "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
21
+ "duration": 7341,
22
+ "durationString": "2:02:21",
23
+ "viewCount": 7565956,
24
+ "uploadDate": null,
25
+ "description": "Master Python from scratch No fluff\u2014just clear, practical coding skills to kickstart your journey! Want to dive deeper? - Check\u00a0...",
26
+ "thumbnails": [
27
+ {
28
+ "url": "https://i.ytimg.com/vi/K5KVEU3aaeQ/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAXbPvWkQhvRSOYWD6mp9EVbfWSYg",
29
+ "width": 360,
30
+ "height": 202
31
+ },
32
+ {
33
+ "url": "https://i.ytimg.com/vi/K5KVEU3aaeQ/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAbeaIhlZJzT49VmWFTFrL3rCq--Q",
34
+ "width": 720,
35
+ "height": 404
36
+ }
37
+ ]
38
+ },
39
+ {
40
+ "videoId": "kqtD5dpn9C8",
41
+ "title": "Python for Beginners - Learn Coding with Python in 1 Hour",
42
+ "channel": "Programming with Mosh",
43
+ "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
44
+ "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
45
+ "duration": 3606,
46
+ "durationString": "1:00:06",
47
+ "viewCount": 25317327,
48
+ "uploadDate": null,
49
+ "description": "Learn Python basics in just 1 hour! Perfect for beginners interested in AI and coding. \u26a1 Plus, get 6 months of PyCharm FREE with\u00a0...",
50
+ "thumbnails": [
51
+ {
52
+ "url": "https://i.ytimg.com/vi/kqtD5dpn9C8/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD1iLVjsmE_gK2uZS887LgyThzx4Q",
53
+ "width": 360,
54
+ "height": 202
55
+ },
56
+ {
57
+ "url": "https://i.ytimg.com/vi/kqtD5dpn9C8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDoYD4sT1l-1w5fEUQt6pdtsKdfLQ",
58
+ "width": 720,
59
+ "height": 404
60
+ }
61
+ ]
62
+ },
63
+ {
64
+ "videoId": "_uQrJ0TkZlc",
65
+ "title": "Python Full Course for Beginners",
66
+ "channel": "Programming with Mosh",
67
+ "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
68
+ "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
69
+ "duration": 22447,
70
+ "durationString": "6:14:07",
71
+ "viewCount": 49011589,
72
+ "uploadDate": null,
73
+ "description": "Learn Python for AI, machine learning, and web development with this beginner-friendly course! Get 6 months of PyCharm\u00a0...",
74
+ "thumbnails": [
75
+ {
76
+ "url": "https://i.ytimg.com/vi/_uQrJ0TkZlc/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCQfkbApoaN-_QBOuiyHzWJOiziEA",
77
+ "width": 360,
78
+ "height": 202
79
+ },
80
+ {
81
+ "url": "https://i.ytimg.com/vi/_uQrJ0TkZlc/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCpUFKfUMVNbg8mqTcZ8UdSUjpilw",
82
+ "width": 720,
83
+ "height": 404
84
+ }
85
+ ]
86
+ },
87
+ {
88
+ "videoId": "ix9cRaBkVe0",
89
+ "title": "Python Full Course for free \ud83d\udc0d",
90
+ "channel": "Bro Code",
91
+ "channelId": "UC4SVo0Ue36XCfOyb5Lh1viQ",
92
+ "channelUrl": "https://www.youtube.com/channel/UC4SVo0Ue36XCfOyb5Lh1viQ",
93
+ "duration": 43200,
94
+ "durationString": "12:00:00",
95
+ "viewCount": 12232736,
96
+ "uploadDate": null,
97
+ "description": "python #tutorial #beginners Python tutorial for beginners' full course 2024 *Learn Python in 1 HOUR*\u00a0...",
98
+ "thumbnails": [
99
+ {
100
+ "url": "https://i.ytimg.com/vi/ix9cRaBkVe0/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDxOlqOI0ajJHiDKDJKd2mEyl6o8Q",
101
+ "width": 360,
102
+ "height": 202
103
+ },
104
+ {
105
+ "url": "https://i.ytimg.com/vi/ix9cRaBkVe0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAOFhprL8-MOLlhL-mAmfQX14h3JA",
106
+ "width": 720,
107
+ "height": 404
108
+ }
109
+ ]
110
+ },
111
+ {
112
+ "videoId": "PLNcg_FV9n7qZGfFl2ANI_zISzNp257Lwn",
113
+ "title": "Python Ultimate Course",
114
+ "channel": "Data with Baraa",
115
+ "channelId": "UC8_RSKwbU1OmZWNEoLV1tQg",
116
+ "channelUrl": "https://www.youtube.com/channel/UC8_RSKwbU1OmZWNEoLV1tQg",
117
+ "duration": null,
118
+ "durationString": null,
119
+ "viewCount": null,
120
+ "uploadDate": null,
121
+ "description": null,
122
+ "thumbnails": [
123
+ {
124
+ "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD0DGP1Fz2uVeT1N4KayechjJWXQQ",
125
+ "width": 360,
126
+ "height": 202
127
+ },
128
+ {
129
+ "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC8xiDHYd35tCqjtIe7zAdNiJV-TQ",
130
+ "width": 720,
131
+ "height": 404
132
+ }
133
+ ]
134
+ },
135
+ {
136
+ "videoId": "ygXn5nV5qFc",
137
+ "title": "Python for AI - Full Beginner Course",
138
+ "channel": "Dave Ebbelaar",
139
+ "channelId": "UCn8ujwUInbJkBhffxqAPBVQ",
140
+ "channelUrl": "https://www.youtube.com/channel/UCn8ujwUInbJkBhffxqAPBVQ",
141
+ "duration": 18931,
142
+ "durationString": "5:15:31",
143
+ "viewCount": 1526371,
144
+ "uploadDate": null,
145
+ "description": "Learn Python from scratch and start building real AI applications. This is the fastest, beginner-friendly course Python for AI\u00a0...",
146
+ "thumbnails": [
147
+ {
148
+ "url": "https://i.ytimg.com/vi/ygXn5nV5qFc/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAWOQBeND4JW5j_bzYI-BmsTplkfQ",
149
+ "width": 360,
150
+ "height": 202
151
+ },
152
+ {
153
+ "url": "https://i.ytimg.com/vi/ygXn5nV5qFc/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBYZK-1TMdAyhLC18-i_BcFkw1TBA",
154
+ "width": 720,
155
+ "height": 404
156
+ }
157
+ ]
158
+ },
159
+ {
160
+ "videoId": "9Hku_7e-JSk",
161
+ "title": "3\u5c0f\u65f6\u8d85\u5feb\u901f\u5165\u95e8Python | \u52a8\u753b\u6559\u5b66\u30102025\u65b0\u7248\u3011\u3010\u81ea\u5b66Python\u6559\u7a0b\u3011\u3010\u96f6\u57fa\u7840Python\u3011",
162
+ "channel": "\u6797\u7c92\u7c92\u5440",
163
+ "channelId": "UCpHMIMmvmBTfr-IefM2mu3A",
164
+ "channelUrl": "https://www.youtube.com/channel/UCpHMIMmvmBTfr-IefM2mu3A",
165
+ "duration": 11459,
166
+ "durationString": "3:10:59",
167
+ "viewCount": 379257,
168
+ "uploadDate": null,
169
+ "description": "\u628aPython\u6559\u7a0b\u505a\u6210\u52a8\u753b\u7247\u4e86\uff0c\u6559\u5b66\u901a\u4fd7\u6613\u61c22025\u6700\u65b0\u7248\uff0c\u5b66\u5b8c\u5165\u95e8\u7f16\u7a0b\uff5e \u5982\u679c\u4f60\u9700\u8981\u8fdb\u9636\u5b66\u4e60Python\uff0c\u6b22\u8fce\u4e86\u89e3\u66f4\u591a\u6211\u5236\u4f5c\u7684\u00a0...",
170
+ "thumbnails": [
171
+ {
172
+ "url": "https://i.ytimg.com/vi/9Hku_7e-JSk/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAQyFmKTug_SY679Uy6_D5TvsipfA",
173
+ "width": 360,
174
+ "height": 202
175
+ },
176
+ {
177
+ "url": "https://i.ytimg.com/vi/9Hku_7e-JSk/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDkae8uL5ujOK-rzpcNGOt030lhPA",
178
+ "width": 720,
179
+ "height": 404
180
+ }
181
+ ]
182
+ },
183
+ {
184
+ "videoId": "nLRL_NcnK-4",
185
+ "title": "Harvard CS50\u2019s Introduction to Programming with Python \u2013 Full University Course",
186
+ "channel": "freeCodeCamp.org and CS50",
187
+ "channelId": null,
188
+ "channelUrl": null,
189
+ "duration": 57468,
190
+ "durationString": "15:57:48",
191
+ "viewCount": 9040599,
192
+ "uploadDate": null,
193
+ "description": "Learn Python programming from Harvard University. It dives more deeply into the design and implementation of web apps with\u00a0...",
194
+ "thumbnails": [
195
+ {
196
+ "url": "https://i.ytimg.com/vi/nLRL_NcnK-4/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAJas_Ng-a8m7MaZy4pFXEtg32wrg",
197
+ "width": 360,
198
+ "height": 202
199
+ },
200
+ {
201
+ "url": "https://i.ytimg.com/vi/nLRL_NcnK-4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA5lx7Ejw4EXmM_Vlc1_bZ3RLKQ7g",
202
+ "width": 720,
203
+ "height": 404
204
+ }
205
+ ]
206
+ },
207
+ {
208
+ "videoId": "Rq5gJVxz55Q",
209
+ "title": "Python Full Course for Beginners (13 Hours) \u2013 From Zero to Hero",
210
+ "channel": "Data with Baraa",
211
+ "channelId": "UC8_RSKwbU1OmZWNEoLV1tQg",
212
+ "channelUrl": "https://www.youtube.com/channel/UC8_RSKwbU1OmZWNEoLV1tQg",
213
+ "duration": 46973,
214
+ "durationString": "13:02:53",
215
+ "viewCount": 1060826,
216
+ "uploadDate": null,
217
+ "description": "Learn Python from scratch in this complete 13-hour course designed for beginners who want to build real programming\u00a0...",
218
+ "thumbnails": [
219
+ {
220
+ "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAuu4tzXeRYigoVzfQEk-yj5Cxpqg",
221
+ "width": 360,
222
+ "height": 202
223
+ },
224
+ {
225
+ "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBPqpz9uFFxOdUMDarDkzaSL2_KRQ",
226
+ "width": 720,
227
+ "height": 404
228
+ }
229
+ ]
230
+ },
231
+ {
232
+ "videoId": "wUSDVGivd-8",
233
+ "title": "Python for Data Analytics - Full Course for Beginners",
234
+ "channel": "Luke Barousse",
235
+ "channelId": "UCLLw7jmFsvfIVaUFsLs8mlQ",
236
+ "channelUrl": "https://www.youtube.com/channel/UCLLw7jmFsvfIVaUFsLs8mlQ",
237
+ "duration": 40181,
238
+ "durationString": "11:09:41",
239
+ "viewCount": 1549508,
240
+ "uploadDate": null,
241
+ "description": "FREE Course Files & Project https://lukeb.co/python_repo Supporter Access: Problems, Certificate, & More\u00a0...",
242
+ "thumbnails": [
243
+ {
244
+ "url": "https://i.ytimg.com/vi/wUSDVGivd-8/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA85GvFR4YuxTeBj67gS7sT8KkPug",
245
+ "width": 360,
246
+ "height": 202
247
+ },
248
+ {
249
+ "url": "https://i.ytimg.com/vi/wUSDVGivd-8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB8qopEPMx651G_KsmN1CSWxlDeIQ",
250
+ "width": 720,
251
+ "height": 404
252
+ }
253
+ ]
254
+ },
255
+ {
256
+ "videoId": "PL-osiE80TeTt2d9bfVyTiXJA-UTHn6WwU",
257
+ "title": "Python Tutorials",
258
+ "channel": "Corey Schafer",
259
+ "channelId": "UCCezIgC97PvUuR4_gbFUs5g",
260
+ "channelUrl": "https://www.youtube.com/channel/UCCezIgC97PvUuR4_gbFUs5g",
261
+ "duration": null,
262
+ "durationString": null,
263
+ "viewCount": null,
264
+ "uploadDate": null,
265
+ "description": null,
266
+ "thumbnails": [
267
+ {
268
+ "url": "https://i.ytimg.com/vi/YYXdXT2l-Gg/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC5xC1ZF2J_u3-jTNz_q31gOoerkw",
269
+ "width": 360,
270
+ "height": 202
271
+ },
272
+ {
273
+ "url": "https://i.ytimg.com/vi/YYXdXT2l-Gg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB62tKrSiLOsKgSqTEWX05gsbf03g",
274
+ "width": 720,
275
+ "height": 404
276
+ }
277
+ ]
278
+ },
279
+ {
280
+ "videoId": "PLsyeobzWxl7poL9JTVyndKe62ieoN-MZ3",
281
+ "title": "Python for Beginners (Full Course) | Programming Tutorial",
282
+ "channel": "Telusko",
283
+ "channelId": "UC59K-uG2A5ogwIrHw4bmlEg",
284
+ "channelUrl": "https://www.youtube.com/channel/UC59K-uG2A5ogwIrHw4bmlEg",
285
+ "duration": null,
286
+ "durationString": null,
287
+ "viewCount": null,
288
+ "uploadDate": null,
289
+ "description": null,
290
+ "thumbnails": [
291
+ {
292
+ "url": "https://i.ytimg.com/vi/QXeEoD0pB3E/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCWPAZkJp7z57q2H_k4GCVXz5DUFw",
293
+ "width": 360,
294
+ "height": 202
295
+ },
296
+ {
297
+ "url": "https://i.ytimg.com/vi/QXeEoD0pB3E/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB0rOknPZGuoCIf-6EgHKR1A6TxTA",
298
+ "width": 720,
299
+ "height": 404
300
+ }
301
+ ]
302
+ },
303
+ {
304
+ "videoId": "PLsyeobzWxl7omDoEYrrf3oXvXxa6MPgek",
305
+ "title": "Python Tutorial 2026 | Complete Python Course (Beginner to Advanced) | Telusko",
306
+ "channel": "Telusko",
307
+ "channelId": "UC59K-uG2A5ogwIrHw4bmlEg",
308
+ "channelUrl": "https://www.youtube.com/channel/UC59K-uG2A5ogwIrHw4bmlEg",
309
+ "duration": null,
310
+ "durationString": null,
311
+ "viewCount": null,
312
+ "uploadDate": null,
313
+ "description": null,
314
+ "thumbnails": [
315
+ {
316
+ "url": "https://i.ytimg.com/vi/YZkyL-f-YXY/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBd7YDpnC51Ceyhi7EkLd0UnfPc9w",
317
+ "width": 360,
318
+ "height": 202
319
+ },
320
+ {
321
+ "url": "https://i.ytimg.com/vi/YZkyL-f-YXY/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLDqwreruXZFgiuPOpWxK28x1IQUMQ",
322
+ "width": 720,
323
+ "height": 404
324
+ }
325
+ ]
326
+ },
327
+ {
328
+ "videoId": "6GuyMZ-cSzE",
329
+ "title": "Python Tutorial for AI: Everything You Need in 2 Hours",
330
+ "channel": "codebasics",
331
+ "channelId": "UCh9nVJoWXmFb7sLApWGcLPQ",
332
+ "channelUrl": "https://www.youtube.com/channel/UCh9nVJoWXmFb7sLApWGcLPQ",
333
+ "duration": 7373,
334
+ "durationString": "2:02:53",
335
+ "viewCount": 196330,
336
+ "uploadDate": null,
337
+ "description": "This Python mini-course is built by keeping in mind the use case of AI. Any AI aspirant who wants to learn AI using Python or want\u00a0...",
338
+ "thumbnails": [
339
+ {
340
+ "url": "https://i.ytimg.com/vi/6GuyMZ-cSzE/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCKgWxeLOO6aMMqu89Wsax4Ccu85g",
341
+ "width": 360,
342
+ "height": 202
343
+ },
344
+ {
345
+ "url": "https://i.ytimg.com/vi/6GuyMZ-cSzE/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDV9Hi0PoMSxKSGNDSd4Io7JMiH-w",
346
+ "width": 720,
347
+ "height": 404
348
+ }
349
+ ]
350
+ },
351
+ {
352
+ "videoId": "rfscVS0vtbw",
353
+ "title": "Learn Python - Full Course for Beginners [Tutorial]",
354
+ "channel": "freeCodeCamp.org",
355
+ "channelId": "UC8butISFwT-Wl7EV0hUK0BQ",
356
+ "channelUrl": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",
357
+ "duration": 16012,
358
+ "durationString": "4:26:52",
359
+ "viewCount": 49285279,
360
+ "uploadDate": null,
361
+ "description": "This course will give you a full introduction into all of the core concepts in python. Follow along with the videos and you'll be a\u00a0...",
362
+ "thumbnails": [
363
+ {
364
+ "url": "https://i.ytimg.com/vi/rfscVS0vtbw/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD-9-7sK2ChwTaU2oDci15jO7wEDg",
365
+ "width": 360,
366
+ "height": 202
367
+ },
368
+ {
369
+ "url": "https://i.ytimg.com/vi/rfscVS0vtbw/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLABBQtpk83-Gm8-IgPAiGlTtrLH9w",
370
+ "width": 720,
371
+ "height": 404
372
+ }
373
+ ]
374
+ },
375
+ {
376
+ "videoId": "xAcTmDO6NTI",
377
+ "title": "Lecture 1: Introduction to CS and Programming Using Python",
378
+ "channel": "MIT OpenCourseWare",
379
+ "channelId": "UCEBb1b_L6zDS3xTUrIALZOw",
380
+ "channelUrl": "https://www.youtube.com/channel/UCEBb1b_L6zDS3xTUrIALZOw",
381
+ "duration": 3810,
382
+ "durationString": "1:03:30",
383
+ "viewCount": 2296795,
384
+ "uploadDate": null,
385
+ "description": "MIT 6.100L Introduction to CS and Programming using Python, Fall 2022 Instructor: Ana Bell View the complete course:\u00a0...",
386
+ "thumbnails": [
387
+ {
388
+ "url": "https://i.ytimg.com/vi/xAcTmDO6NTI/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDZ5a1dBlEdpB7Xmrvg164lDqjy1Q",
389
+ "width": 360,
390
+ "height": 202
391
+ },
392
+ {
393
+ "url": "https://i.ytimg.com/vi/xAcTmDO6NTI/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBQapxSAyS3sQq1FtatNJ0ja36MFA",
394
+ "width": 720,
395
+ "height": 404
396
+ }
397
+ ]
398
+ },
399
+ {
400
+ "videoId": "PLdo5W4Nhv31bZSiqiOL5ta39vSnBxpOPT",
401
+ "title": "Python Full Course",
402
+ "channel": "Jenny's Lectures CS IT",
403
+ "channelId": "UCM-yUTYGmrNvKOCcAl21g3w",
404
+ "channelUrl": "https://www.youtube.com/channel/UCM-yUTYGmrNvKOCcAl21g3w",
405
+ "duration": null,
406
+ "durationString": null,
407
+ "viewCount": null,
408
+ "uploadDate": null,
409
+ "description": null,
410
+ "thumbnails": [
411
+ {
412
+ "url": "https://i.ytimg.com/vi/6i3EGqOBRiU/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLA8vm9XyKYbEzPwshASn00OZzfvBw",
413
+ "width": 360,
414
+ "height": 202
415
+ },
416
+ {
417
+ "url": "https://i.ytimg.com/vi/6i3EGqOBRiU/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCuzoXzg904azzFqkMR6VN_9vPdjA",
418
+ "width": 720,
419
+ "height": 404
420
+ }
421
+ ]
422
+ },
423
+ {
424
+ "videoId": "b093aqAZiPU",
425
+ "title": "\ud83d\udc69\u200d\ud83d\udcbb Python for Beginners Tutorial",
426
+ "channel": "Kevin Stratvert",
427
+ "channelId": "UCfJT_eYDTmDE-ovKaxVE1ig",
428
+ "channelUrl": "https://www.youtube.com/channel/UCfJT_eYDTmDE-ovKaxVE1ig",
429
+ "duration": 3801,
430
+ "durationString": "1:03:21",
431
+ "viewCount": 4592374,
432
+ "uploadDate": null,
433
+ "description": "In this step-by-step Python for beginner's tutorial, learn how you can get started programming in Python. In this video, I assume\u00a0...",
434
+ "thumbnails": [
435
+ {
436
+ "url": "https://i.ytimg.com/vi/b093aqAZiPU/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBMc52n3VeviTzlhsRCemDDz8l1Ow",
437
+ "width": 360,
438
+ "height": 202
439
+ },
440
+ {
441
+ "url": "https://i.ytimg.com/vi/b093aqAZiPU/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBG6MYAXELGegdhLlZJPKwwLierDA",
442
+ "width": 720,
443
+ "height": 404
444
+ }
445
+ ]
446
+ },
447
+ {
448
+ "videoId": "Y8Tko2YC5hA",
449
+ "title": "What is Python? Why Python is So Popular?",
450
+ "channel": "Programming with Mosh",
451
+ "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
452
+ "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
453
+ "duration": 247,
454
+ "durationString": "4:07",
455
+ "viewCount": 2341508,
456
+ "uploadDate": null,
457
+ "description": "What is Python? This short video explains it in 4 minutes. Python Tutorial for Beginners: https://youtu.be/_uQrJ0TkZlc Python\u00a0...",
458
+ "thumbnails": [
459
+ {
460
+ "url": "https://i.ytimg.com/vi/Y8Tko2YC5hA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLC9k_U_x1CBmU1p1YwHz-TTyPBLpg",
461
+ "width": 360,
462
+ "height": 202
463
+ },
464
+ {
465
+ "url": "https://i.ytimg.com/vi/Y8Tko2YC5hA/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAHduruMh6QwyHhLnNsE9WwQSQjxg",
466
+ "width": 720,
467
+ "height": 404
468
+ }
469
+ ]
470
+ },
471
+ {
472
+ "videoId": "VchuKL44s6E",
473
+ "title": "Python As Fast as Possible - Learn Python in ~75 Minutes",
474
+ "channel": "Tech With Tim",
475
+ "channelId": "UC4JX40jDee_tINbkjycV4Sg",
476
+ "channelUrl": "https://www.youtube.com/channel/UC4JX40jDee_tINbkjycV4Sg",
477
+ "duration": 4781,
478
+ "durationString": "1:19:41",
479
+ "viewCount": 2255229,
480
+ "uploadDate": null,
481
+ "description": "GET MY FREE SOFTWARE DEVELOPMENT GUIDE https://training.techwithtim.net/free-guide This python tutorial aims to teach\u00a0...",
482
+ "thumbnails": [
483
+ {
484
+ "url": "https://i.ytimg.com/vi/VchuKL44s6E/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB6udnq8elg0jaxG5wKibJxNCLkPA",
485
+ "width": 360,
486
+ "height": 202
487
+ },
488
+ {
489
+ "url": "https://i.ytimg.com/vi/VchuKL44s6E/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB5Ob2qlI0bsygtt2fHQlnsF7yiaQ",
490
+ "width": 720,
491
+ "height": 404
492
+ }
493
+ ]
494
+ }
495
+ ],
496
+ "totalResults": 20,
497
+ "query": "python"
498
+ }
499
+ ],
500
+ "usage": {
501
+ "credits": 0.05
502
+ },
503
+ "created_at": "2026-09-16T07:41:46.808Z"
504
+ }
505
+ }
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,251 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "$defs": {
3
+ "YouTubeSearchFilters": {
4
+ "additionalProperties": false,
5
+ "description": "Optional YouTube search filters, including feature flags.",
6
+ "properties": {
7
+ "duration": {
8
+ "anyOf": [
9
+ {
10
+ "enum": [
11
+ "<4",
12
+ "4-20",
13
+ ">20"
14
+ ],
15
+ "type": "string"
16
+ },
17
+ {
18
+ "type": "null"
19
+ }
20
+ ],
21
+ "default": null,
22
+ "title": "Duration"
23
+ },
24
+ "sort_by": {
25
+ "anyOf": [
26
+ {
27
+ "enum": [
28
+ "rating",
29
+ "relevance",
30
+ "view_count",
31
+ "upload_date"
32
+ ],
33
+ "type": "string"
34
+ },
35
+ {
36
+ "type": "null"
37
+ }
38
+ ],
39
+ "default": null,
40
+ "title": "Sort By"
41
+ },
42
+ "type": {
43
+ "anyOf": [
44
+ {
45
+ "enum": [
46
+ "video",
47
+ "channel",
48
+ "playlist",
49
+ "movie"
50
+ ],
51
+ "type": "string"
52
+ },
53
+ {
54
+ "type": "null"
55
+ }
56
+ ],
57
+ "default": null,
58
+ "title": "Type"
59
+ },
60
+ "upload_date": {
61
+ "anyOf": [
62
+ {
63
+ "enum": [
64
+ "today",
65
+ "last_hour",
66
+ "this_week",
67
+ "this_month",
68
+ "this_year"
69
+ ],
70
+ "type": "string"
71
+ },
72
+ {
73
+ "type": "null"
74
+ }
75
+ ],
76
+ "default": null,
77
+ "title": "Upload Date"
78
+ },
79
+ "360": {
80
+ "anyOf": [
81
+ {
82
+ "type": "boolean"
83
+ },
84
+ {
85
+ "type": "null"
86
+ }
87
+ ],
88
+ "default": null,
89
+ "title": "360"
90
+ },
91
+ "3d": {
92
+ "anyOf": [
93
+ {
94
+ "type": "boolean"
95
+ },
96
+ {
97
+ "type": "null"
98
+ }
99
+ ],
100
+ "default": null,
101
+ "title": "3D"
102
+ },
103
+ "4k": {
104
+ "anyOf": [
105
+ {
106
+ "type": "boolean"
107
+ },
108
+ {
109
+ "type": "null"
110
+ }
111
+ ],
112
+ "default": null,
113
+ "title": "4K"
114
+ },
115
+ "creative_commons": {
116
+ "anyOf": [
117
+ {
118
+ "type": "boolean"
119
+ },
120
+ {
121
+ "type": "null"
122
+ }
123
+ ],
124
+ "default": null,
125
+ "title": "Creative Commons"
126
+ },
127
+ "hd": {
128
+ "anyOf": [
129
+ {
130
+ "type": "boolean"
131
+ },
132
+ {
133
+ "type": "null"
134
+ }
135
+ ],
136
+ "default": null,
137
+ "title": "Hd"
138
+ },
139
+ "hdr": {
140
+ "anyOf": [
141
+ {
142
+ "type": "boolean"
143
+ },
144
+ {
145
+ "type": "null"
146
+ }
147
+ ],
148
+ "default": null,
149
+ "title": "Hdr"
150
+ },
151
+ "live": {
152
+ "anyOf": [
153
+ {
154
+ "type": "boolean"
155
+ },
156
+ {
157
+ "type": "null"
158
+ }
159
+ ],
160
+ "default": null,
161
+ "title": "Live"
162
+ },
163
+ "location": {
164
+ "anyOf": [
165
+ {
166
+ "type": "boolean"
167
+ },
168
+ {
169
+ "type": "null"
170
+ }
171
+ ],
172
+ "default": null,
173
+ "title": "Location"
174
+ },
175
+ "purchased": {
176
+ "anyOf": [
177
+ {
178
+ "type": "boolean"
179
+ },
180
+ {
181
+ "type": "null"
182
+ }
183
+ ],
184
+ "default": null,
185
+ "title": "Purchased"
186
+ },
187
+ "subtitles": {
188
+ "anyOf": [
189
+ {
190
+ "type": "boolean"
191
+ },
192
+ {
193
+ "type": "null"
194
+ }
195
+ ],
196
+ "default": null,
197
+ "title": "Subtitles"
198
+ },
199
+ "vr180": {
200
+ "anyOf": [
201
+ {
202
+ "type": "boolean"
203
+ },
204
+ {
205
+ "type": "null"
206
+ }
207
+ ],
208
+ "default": null,
209
+ "title": "Vr180"
210
+ }
211
+ },
212
+ "title": "YouTubeSearchFilters",
213
+ "type": "object"
214
+ }
215
+ },
216
+ "additionalProperties": false,
217
+ "description": "Larger searches have a separate source and rate; count is not guaranteed.",
218
+ "properties": {
219
+ "query": {
220
+ "description": "YouTube search query, between 1 and 2,000 characters.",
221
+ "maxLength": 2000,
222
+ "minLength": 1,
223
+ "title": "Query",
224
+ "type": "string"
225
+ },
226
+ "max_results": {
227
+ "default": 20,
228
+ "description": "Requested result limit, up to 700.",
229
+ "maximum": 700,
230
+ "minimum": 1,
231
+ "title": "Max Results",
232
+ "type": "integer"
233
+ },
234
+ "filters": {
235
+ "anyOf": [
236
+ {
237
+ "$ref": "#/$defs/YouTubeSearchFilters"
238
+ },
239
+ {
240
+ "type": "null"
241
+ }
242
+ ],
243
+ "default": null
244
+ }
245
+ },
246
+ "required": [
247
+ "query"
248
+ ],
249
+ "title": "YouTubeExtendedSearchInput",
250
+ "type": "object"
251
+ }
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,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "slug": "youtube-extended-search-flashdata",
3
+ "title": "YouTube extended research discovery \u2014 FlashData",
4
+ "scenario": "Explore a broader set of YouTube videos when a small reading list is insufficient. Request a larger topic sample, retain IDs and source channels, then deduplicate and filter it for your research criteria.",
5
+ "task": "Collect a larger candidate set of battery recycling videos for manual review.",
6
+ "input": {
7
+ "query": "battery recycling",
8
+ "max_results": 100
9
+ },
10
+ "path": "results.0.results",
11
+ "fields": [
12
+ "videoId",
13
+ "title",
14
+ "channel",
15
+ "uploadDate",
16
+ "duration"
17
+ ],
18
+ "next": "Use returned IDs to build a review queue. Record the search query and date; the result set is not a complete census of YouTube.",
19
+ "limit": "Up to 700 requested results, default 20; fewer may be available. This is a separate API source with a separate rate, not pagination for standard search.",
20
+ "source": "youtube_search_extended",
21
+ "repo_id": "flashdata-dev/youtube-extended-search-flashdata"
22
+ }
tool.py ADDED
@@ -0,0 +1,23 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from smolagents import Tool
2
+
3
+
4
+ class FlashDataTool(Tool):
5
+ name = 'youtube_search_extended'
6
+ description = 'Explore a broader set of YouTube videos when a small reading list is insufficient. Request a larger topic sample, retain IDs and source channels, then deduplicate and filter it for your research criteria. Up to 700 requested results, default 20; fewer may be available. This is a separate API source with a separate rate, not pagination for standard search. Uses paid FlashData API credits. Never automatically retry an uncertain submission; check Jobs first.'
7
+ inputs = {'filters': {'description': 'Optional YouTube filters: duration, sort_by, type, upload_date and '
8
+ 'boolean feature flags. See the input validation schema in the '
9
+ 'documentation for supported values. Default: None.',
10
+ 'nullable': True,
11
+ 'type': 'object'},
12
+ 'max_results': {'description': 'Requested result limit, up to 700. minimum: 1. maximum: 700. '
13
+ 'Default: 20.',
14
+ 'nullable': True,
15
+ 'type': 'integer'},
16
+ 'query': {'description': 'YouTube search query, between 1 and 2,000 characters.',
17
+ 'type': 'string'}}
18
+ output_type = 'object'
19
+
20
+ def forward(self, query: str, max_results: int = 20, filters: dict | None = None) -> dict:
21
+ from langchain_flashdata import FlashDataYouTubeExtendedSearch
22
+ values = {'query': query, 'max_results': max_results, 'filters': filters}
23
+ return FlashDataYouTubeExtendedSearch().invoke({key: value for key, value in values.items() if value is not None})