Переглянути документацію
Посібники
Зберігайте результат оригінальним входом, вихідних посилань і використання, після чого поверніть його на інший процес без іншого запиту.
На цій сторінці
Запитайте один раз, використовуйте результат по завданнях
Побудуйте звіт, перейміть парсер або дайте пізніше агента крок однакових доказів. Цей робочий потік зберігає один пошук як портативний архів; читання, що архів потребує ні ключ FlashData, ні оригінальний стан CLI.
archive/saved-search/
request.json оригінальний запит та параметри
response.json безконтактний API відповідь
citations.ndjson заголовки, джерело URLs і snippets
manifest.json запустіть ID, використання, розміри файлів і SHA-256Перед тим, як початися
Використовуйте нову робочу папку, FlashData CLI з дозволом google_search та наявними кредитами. За допомогою автентифікованого профілю або FLASHDATA_API_KEY. Bash перевірить використання jq; Windows використовує PowerShell 7. У локальному архіві використовуються сценарії Python 3.10+ та його стандартна бібліотека.
Продовжити, коли data.accessVerified true. Для CLI ретрі, зберігайте той самий профіль, OS користувача та державного каталогу. Засіб має навантажувати наявний потенціал з його секретного магазину.
flashdata auth status --json1. Зберігати вхід і зберегти одну відповідь
Заощаджуйте request.json нижче, потім запустіть одну команду. --input використовує цей точний запит; зберігайте файл незмінним після завершення. --output зберігає тіло API в search.json; --json друкує CLI метаданих. збережено-дослідний пошук є локальним запуском ID.
{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}flashdata query --input request.json \
--run-id saved-search --output search.json --jsonflashdata query --input request.json `
--run-id saved-search --output search.json --json2. Дійсність збереженої відповіді
Джерело: google_search, status: done та масив результатів. Друк кожного органічного імені результата, посилання та хіппе. В залежності від того, що в іншому випадку є нездійсненна збірка, яка не відповідає вимогам або відсутній поле.
jq -e '.source == "google_search" and .status == "done"
and (.results | type == "array")
and all(.results[]; (.organic | type == "array"))' search.json > /dev/null &&
jq -c '.results[] | .organic[] | {title, link, snippet}' search.json$result = Get-Content -Raw -LiteralPath search.json | ConvertFrom-Json
if ($result.source -ne 'google_search' -or $result.status -ne 'done' -or
-not ($result.results -is [array])) {
throw 'Inspect search.json before treating the task as complete.'
}
foreach ($page in $result.results) {
if (-not ($page.organic -is [array])) { throw 'Missing organic results array.' }
$page.organic | Select-Object title, link, snippet
}3. Архів вхідних, реанімаційних та цитувань
Заощаджуйте archive.py нижче, потім запустіть його з запустіть ID з кроку 1. Він зберігає сирі файли, екстракти вихідних посилань і пише manifest.json, останні з файлами, контрольними та використання файлів. Очікується complete: true; кількість цитування залежить від результатів пошуку. Немає мережевих запитів.
Зберегти archive.py
Створіть archive.py з request.json та search.json у робочій папці. Скопіюйте загальний код нижче в ньому і заощаджуйте його.
Прикладні архіви Google Search результати. Неактуальні каталоги архівів зберігаються. Тримайте request.json, search.json і збігається разом до завершення архівування.
# archive.py — Python 3.10+, standard library only; no network requests.
import argparse
import hashlib
import json
import re
from datetime import datetime, timezone
from pathlib import Path
from urllib.parse import urlsplit
parser = argparse.ArgumentParser()
parser.add_argument('--run-id', required=True)
args = parser.parse_args()
if not re.fullmatch(r'[A-Za-z0-9_-]+', args.run_id):
raise ValueError('Use the CLI run ID from this task.')
request_bytes = Path('request.json').read_bytes()
result_bytes = Path('search.json').read_bytes()
request = json.loads(request_bytes.decode('utf-8-sig'))
result = json.loads(result_bytes.decode('utf-8-sig'))
if (request.get('source') != 'google_search' or result.get('source') != request['source']
or result.get('status') not in ['done', 'completed']
or not isinstance(result.get('results'), list)):
raise ValueError('Inspect the request and result before archiving.')
citations = []
for page in result['results']:
if not isinstance(page, dict) or not isinstance(page.get('organic'), list):
raise ValueError('Expected an organic results array, including when it is empty.')
for item in page['organic']:
if not isinstance(item, dict) or not isinstance(item.get('link'), str):
raise ValueError('A result is missing its source URL.')
url = urlsplit(item['link'])
if url.scheme not in ['http', 'https'] or not url.netloc:
raise ValueError('Inspect an unexpected source URL.')
citations.append({key: item.get(key, '') for key in ['title', 'link', 'snippet']})
files = {'request.json': request_bytes, 'response.json': result_bytes,
'citations.ndjson': ''.join(json.dumps(row, ensure_ascii=False) + '\n'
for row in citations).encode('utf-8')}
manifest = {'version': 1, 'run_id': args.run_id, 'source': request['source'],
'archived_at': datetime.now(timezone.utc).isoformat(),
'usage': result.get('usage'), 'citation_count': len(citations),
'files': {name: {'bytes': len(data), 'sha256': hashlib.sha256(data).hexdigest()}
for name, data in files.items()}}
folder = Path('archive') / args.run_id
folder.mkdir(parents=True) # Existing archives are preserved. Choose a new run ID for new work.
for name, data in files.items():
with (folder / name).open('xb') as output:
output.write(data)
# Write the manifest last. Without it, the archive is incomplete.
with (folder / 'manifest.json').open('x', encoding='utf-8') as output:
json.dump(manifest, output, ensure_ascii=False, indent=2)
print(json.dumps({'archive': str(folder), 'citations': len(citations), 'complete': True}))Створення архіву
Запуск з папки, що містить archive.py, request.json і search.json.
python3 archive.py --run-id saved-searchpython archive.py --run-id saved-search4. Зловживання архівом без облікових даних
Збережіть reuse.py нижче. Скопіюйте повну папку archive/saved-search до процесу, який його потребує, потім запустіть цей зчитувач. Вивержає кожен файл перед друком оригінального запиту, використання та цитування. Працює після відкликання API-key або розміщення-відновлення терміну придатності, оскільки він читає лише вашу збережену копію.
Зберегти reuse.py
Створіть reuse.py у робочій папці, що містить archive/. На іншій машині скопіюйте як reuse.py, так і повний каталог archive/saved-search, зберігаючи цей макет.
# reuse.py — run without a FlashData key or CLI.
import hashlib
import json
import sys
from pathlib import Path
folder = Path(sys.argv[1])
manifest = json.loads((folder / 'manifest.json').read_text(encoding='utf-8'))
expected = {'request.json', 'response.json', 'citations.ndjson'}
if manifest.get('version') != 1 or set(manifest.get('files', {})) != expected:
raise ValueError('Unknown or incomplete archive manifest.')
files = {}
for name in sorted(expected):
data = (folder / name).read_bytes()
record = manifest['files'][name]
if len(data) != record['bytes'] or hashlib.sha256(data).hexdigest() != record['sha256']:
raise ValueError('Archive changed or was not fully copied: ' + name)
files[name] = data
request = json.loads(files['request.json'].decode('utf-8-sig'))
citations = [json.loads(line) for line in files['citations.ndjson'].decode('utf-8').splitlines()]
if len(citations) != manifest['citation_count']:
raise ValueError('Citation count does not match the manifest.')
print(json.dumps({'run_id': manifest['run_id'], 'query': request['query'],
'archived_at': manifest['archived_at'], 'usage': manifest['usage'],
'citations': citations}, indent=2))Читати збережений архів
Заощаджуйте reuse.py, потім запустіть з папки. Остаточний аргумент - шлях до скопійованого архіву.
python3 reuse.py archive/saved-searchpython reuse.py archive/saved-searchЕкспорт з журналу CLI замість
Якщо ви ще маєте оригінальний профіль CLI та державний каталог, експорт збереженого запуску до нового імені файлу. Це не робить нового запиту, але він вирішить доступ до Інтернету. Чи можна прочитати файл, який не містить цього параметра.
flashdata runs show saved-search --result --output search-copy.json --jsonВипадковий при повторному використанні або оновленні
archived_at записів, коли ви збережені файли, не коли змінилася початкова сторінка. Ваша заявка вирішить, як недавнє доказування повинно бути; копіювання файлу не освіжає його зміст.
| Заява | Дія |
|---|---|
| Виконувати аналізатор, відновити звіт або продовжити крок агента | Зловживання збереженою відповідь. Зберігати джерело URLs, параметри запиту та використання з ним. |
| Провести новий щоденний брифінг або відповісти на зміни запиту | Створіть нову task/run ID, папку та архів. Зберігайте старі знімки, як історія. |
| Використання графів у отриманих файлах | Перерахуйте оригінальні запити один раз. Скопіювати відповідь або зробити інший звіт не створює іншого заряду. |
Знайте, що закінчується
| Поповнення | Що робити | Закінчення |
|---|---|---|
| Realtime запит | Файл відповіді та оригінальний вхід | Ваша збережена копія повинна бути використана |
| Async / Batch робота | Робота ID, отримання та результат JSON | 24 годин після завершення |
| Bulk | Manifest і всі частини NDJSON | 24 годин після завершення роботи; перевірте expiresAt |
| YouTube Download | Доставка JSON і медіа в вашому напрямку | Доставка JSON: утримання робочих місць. Медіа: твій цикл відра |
| MCP круглий кеш | Повністю зібраний результат | 10 хвилини; тільки чотири нові результати за API ключ зберігають |
Зберігайте невеликий боковий автомобіль замість
Зберігайте оригінальну відповідь незмінною. Заощаджуйте невеликий бічний автомобіль з входом, джерело, заощаджуйте час і використання, щоб пізніше процес може зрозуміти, що виробляється файл. Зберігати джерело URLs і відеоразами при перетворенні результатів.
(
set -euC
jq --arg run_id 'saved-search' --slurpfile request request.json \
'{run_id: $run_id, source, input: $request[0],
saved_at: (now | todateiso8601), result_file: "search.json", usage}' \
search.json > search-record.json
cat search-record.json
)Заощаджуйте безпосередньо з HTTP
Використовуйте це замість запиту CLI на крок 1. Заощаджуйте той самий request.json першим; це працює один новий запит за допомогою Bash, cURL 7.76+ і jq. Запобігання FLASHDATA_API_KEY і вибрати папку без search.json. Після перевірки, ті ж сценарії архіву працюють з цим результатом; оберіть власне завдання ID для --run-id.
Незеро cURL вихід означає, що результат не готовий до використання. Перевірте збережену відповідь перед спрацьовуванням; час з'єднання може статися після того, як було прийнято запит. Використовуйте команду перевірки в крокі 2.
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test -f request.json
curl --fail-with-body --silent --show-error --max-time 120 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' --header 'Accept: application/json' \
--data-binary @request.json > search.json
jq . search.json
)Заощаджуйте існуючу роботу фону
Використовуйте submission.json з інструкції з асинхронності та однакового облікового запису. Ці команди отримують існуючу роботу; вони не подають іншого запиту. CLI очікує на завершення і ручить результат перенаправлення. Заощаджуйте результат в рамках 24 годин завершення.
(
set -euC
JOB_ID=$(jq -er '.remoteId // .id // .submission.id' submission.json)
flashdata jobs wait "$JOB_ID" --json
flashdata jobs result "$JOB_ID" --output job-result.json --json
jq '{source, status, results, usage}' job-result.json
)Перевірка стану припиняється, якщо робота не завершена. Якщо це все ще черга або працює, почекайте і запустіть цей чит-only snippet знову; перевірте невдалу роботу замість того, щоб. A 302 скачати без переадресації ключа API. Наведено тимчасову відповідь перед job-result.json.
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e job-result.json || { echo 'Choose a new output filename.' >&2; exit 1; }
JOB_ID=$(jq -er '.remoteId // .id // .submission.id' submission.json)
printf '%s' "$JOB_ID" | grep -Eq '^[A-Za-z0-9_-]+$'
SOURCE=$(jq -er '(.submission // .).source' submission.json)
API="https://api.flashdata.dev/v2/jobs/$JOB_ID"
curl --fail-with-body --silent --show-error \
--max-time 30 --header "X-API-Key: $FLASHDATA_API_KEY" "$API" >| job-status.json
jq -e --arg id "$JOB_ID" --arg source "$SOURCE" \
'.job.id == $id and .job.source == $source and .job.status == "completed"' job-status.json >/dev/null
STATUS=$(curl --silent --show-error \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--max-time 120 --dump-header result-headers.txt --output job-result.pending \
--write-out '%{http_code}' "$API/results")
case "$STATUS" in
200) ;;
302)
LOCATION=$(awk 'tolower($1) == "location:" { sub(/\r$/, "", $2); print $2 }' result-headers.txt)
# No FlashData API key on the signed storage request.
curl --fail-with-body --silent --show-error --compressed --max-time 120 \
--proto '=https' --output job-result.pending "$LOCATION" ;;
*) echo "HTTP $STATUS: inspect job-result.pending and result-headers.txt." >&2; exit 1 ;;
esac
jq -e --arg source "$SOURCE" '.source == $source and (.status == "done" or .status == "completed")
and (.results | type == "array")' job-result.pending >/dev/null
cat job-result.pending > job-result.json
jq '{source, status, results, usage}' job-result.json
)Заощаджуйте кожен результат Bulk
Замініть BULK_ID з ID у Вашій заявці. Після завершення роботи, CLI слід проявляти і зберігає кожну частину як один файл NDJSON. Зберігайте прояву занадто, коли вам потрібно розраховувати і розділити метадані.
Файл може містити як успішні, так і невдалі рядки. Індекси введення і підрахунки перед маркуванням повного завдання. Не запустіть весь вхідний файл, щоб відновити один невдалий ряд.
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --jsonЗберігайте запис і ЗМІ
delivery.json містить запис доставки, не відео або аудіобайтів. Заощаджуйте URL, розмір і контрольний запас разом з завданням. У медіа-ресурсі, що зберігається у вашому місці, і слідуйте за тим, що життєвий цикл зберігання.
Для приватного призначення скористайтеся обліковими записами провайдера або підписаним URL для перевірки об’єкта. Відсутній тимчасовий результат JSON не означає, що ваші збережені медіа були видалені.
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.jsonАсемблея MCP роз'єми перед економією
Коли інструмент повертає result_id, штучок і next_offset, читати інші шматки з get_result за допомогою того ж ключа API. Використовуйте точний next_offset, який повертається за допомогою інструмента; значення нижче розміщуються власники.
- Закінчіть кожну куртку в офсетному порядку. Перейдіть за next_offset до null.
- Після того, як JSON, напишіть весь результат на власний файл або сховище.
- Заощаджуйте до expires_at. Нові великі відповіді можуть виявляти старі результати до 10-хвилину ліміт; кеш зберігає чотири за API ключ.
{
"name": "get_result",
"arguments": {
"result_id": "RESULT_ID_FROM_TOOL",
"offset": 16000
}
}Збереження та ретривальні проблеми
| Проблема | Фіксація |
|---|---|
| Вихідний файл вже існує | Інспекція першого. Для завершення роботи CLI використовуйте runs show з новим вихідним іменем замість подачі іншої запиту. |
| CLI не може знайти роботу | Використовуйте оригінальний OS користувача, профіль та державний каталог. Якщо ви зберігали віддалену роботу ID, отримайте цю роботу безпосередньо. |
| 401 / 403 на повторному використанні | Запуск флешки auth status --json і відновлення дійсного доступу. У локальному файлі вже збережено ще можна прочитати без доступу до API. |
| 409 / 410 | 409: очікування існуючої роботи. 410: використовувати збережену копію; тимчасовий результат вибухнув. |
| Похибка диска після запиту | Запуск ID або робота ID. Виправлення зберігання і відновлення існуючої роботи перед розглядом нового подання. |
| Архів не проявляється або не виходить з ладу | Відновити або копіювати оригінальні файли знову. Зберігати неповний архів для перевірки; перебудувати архів не потрібно нового запиту. |
| MCP · result_unavailable | Перевірити результат ID, офсет, API ключ і витривалість. Використовуйте збережену копію, якщо кеш перевищено; не петля, повторюючи платну квитанцію. |