Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Заощаджувати та повторно використовувати результати

Зберігайте результат оригінальним входом, вихідних посилань і використання, після чого поверніть його на інший процес без іншого запиту.

На цій сторінці

Запитайте один раз, використовуйте результат по завданнях

Побудуйте звіт, перейміть парсер або дайте пізніше агента крок однакових доказів. Цей робочий потік зберігає один пошук як портативний архів; читання, що архів потребує ні ключ 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 --json

1. Зберігати вхід і зберегти одну відповідь

Заощаджуйте request.json нижче, потім запустіть одну команду. --input використовує цей точний запит; зберігайте файл незмінним після завершення. --output зберігає тіло API в search.json; --json друкує CLI метаданих. збережено-дослідний пошук є локальним запуском ID.

request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
Запуск одного пошуку
flashdata query --input request.json \
  --run-id saved-search --output search.json --json

2. Дійсність збереженої відповіді

Джерело: google_search, status: done та масив результатів. Друк кожного органічного імені результата, посилання та хіппе. В залежності від того, що в іншому випадку є нездійсненна збірка, яка не відповідає вимогам або відсутній поле.

Дійсно і читати search.json
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

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
# 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-search

4. Зловживання архівом без облікових даних

Збережіть reuse.py нижче. Скопіюйте повну папку archive/saved-search до процесу, який його потребує, потім запустіть цей зчитувач. Вивержає кожен файл перед друком оригінального запиту, використання та цитування. Працює після відкликання API-key або розміщення-відновлення терміну придатності, оскільки він читає лише вашу збережену копію.

Зберегти reuse.py

Створіть reuse.py у робочій папці, що містить archive/. На іншій машині скопіюйте як reuse.py, так і повний каталог archive/saved-search, зберігаючи цей макет.

reuse.py
# 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-search

Експорт з журналу CLI замість

Якщо ви ще маєте оригінальний профіль CLI та державний каталог, експорт збереженого запуску до нового імені файлу. Це не робить нового запиту, але він вирішить доступ до Інтернету. Чи можна прочитати файл, який не містить цього параметра.

Експорт готової забігу
flashdata runs show saved-search --result --output search-copy.json --json

Випадковий при повторному використанні або оновленні

archived_at записів, коли ви збережені файли, не коли змінилася початкова сторінка. Ваша заявка вирішить, як недавнє доказування повинно бути; копіювання файлу не освіжає його зміст.

ЗаяваДія
Виконувати аналізатор, відновити звіт або продовжити крок агентаЗловживання збереженою відповідь. Зберігати джерело URLs, параметри запиту та використання з ним.
Провести новий щоденний брифінг або відповісти на зміни запитуСтворіть нову task/run ID, папку та архів. Зберігайте старі знімки, як історія.
Використання графів у отриманих файлахПерерахуйте оригінальні запити один раз. Скопіювати відповідь або зробити інший звіт не створює іншого заряду.

Знайте, що закінчується

ПоповненняЩо робитиЗакінчення
Realtime запитФайл відповіді та оригінальний вхідВаша збережена копія повинна бути використана
Async / Batch роботаРобота ID, отримання та результат JSON24 годин після завершення
BulkManifest і всі частини NDJSON24 годин після завершення роботи; перевірте expiresAt
YouTube DownloadДоставка JSON і медіа в вашому напрямкуДоставка JSON: утримання робочих місць. Медіа: твій цикл відра
MCP круглий кешПовністю зібраний результат10 хвилини; тільки чотири нові результати за API ключ зберігають

Зберігайте невеликий боковий автомобіль замість

Зберігайте оригінальну відповідь незмінною. Заощаджуйте невеликий бічний автомобіль з входом, джерело, заощаджуйте час і використання, щоб пізніше процес може зрозуміти, що виробляється файл. Зберігати джерело URLs і відеоразами при перетворенні результатів.

Bash / jq · search-record.json
(
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
Заощаджуйте відповідь API
(
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
)

Заощаджуйте кожен результат Bulk

Замініть BULK_ID з ID у Вашій заявці. Після завершення роботи, CLI слід проявляти і зберігає кожну частину як один файл NDJSON. Зберігайте прояву занадто, коли вам потрібно розраховувати і розділити метадані.

Файл може містити як успішні, так і невдалі рядки. Індекси введення і підрахунки перед маркуванням повного завдання. Не запустіть весь вхідний файл, щоб відновити один невдалий ряд.

Збір завершеної роботи
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --json

Зберігайте запис і ЗМІ

delivery.json містить запис доставки, не відео або аудіобайтів. Заощаджуйте URL, розмір і контрольний запас разом з завданням. У медіа-ресурсі, що зберігається у вашому місці, і слідуйте за тим, що життєвий цикл зберігання.

Для приватного призначення скористайтеся обліковими записами провайдера або підписаним URL для перевірки об’єкта. Відсутній тимчасовий результат JSON не означає, що ваші збережені медіа були видалені.

Перевірте збережений результат завантаження · jq
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.json

Асемблея MCP роз'єми перед економією

Коли інструмент повертає result_id, штучок і next_offset, читати інші шматки з get_result за допомогою того ж ключа API. Використовуйте точний next_offset, який повертається за допомогою інструмента; значення нижче розміщуються власники.

  1. Закінчіть кожну куртку в офсетному порядку. Перейдіть за next_offset до null.
  2. Після того, як JSON, напишіть весь результат на власний файл або сховище.
  3. Заощаджуйте до expires_at. Нові великі відповіді можуть виявляти старі результати до 10-хвилину ліміт; кеш зберігає чотири за API ключ.
MCP tools/call аргументи
{
  "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 / 410409: очікування існуючої роботи. 410: використовувати збережену копію; тимчасовий результат вибухнув.
Похибка диска після запитуЗапуск ID або робота ID. Виправлення зберігання і відновлення існуючої роботи перед розглядом нового подання.
Архів не проявляється або не виходить з ладуВідновити або копіювати оригінальні файли знову. Зберігати неповний архів для перевірки; перебудувати архів не потрібно нового запиту.
MCP · result_unavailableПеревірити результат ID, офсет, API ключ і витривалість. Використовуйте збережену копію, якщо кеш перевищено; не петля, повторюючи платну квитанцію.