USA Data Tools AI Tool Guide

Purpose:
USA Data Tools compares EDI, JSON, XML, and plain-text payloads in the browser. It is useful for AI agents, QA teams, EDI analysts, and integration support workflows that need a quick local diff view.

It can also convert delimited files between comma CSV, pipe, tab, and semicolon formats with browser-local processing.

Primary compare route:
/#compare

Payload-value compare:
/#compare?leftValue={url_encoded_left_payload}&rightValue={url_encoded_right_payload}

Path setup compare:
/#compare?left={url_encoded_left_path}&right={url_encoded_right_path}

Important browser limitation:
Public websites cannot silently read arbitrary local file paths. Path parameters are useful for local workflows, saved launchers, dev-server workflows, and user-assisted file loading.

Payload limits:
Local files are limited to 2 MB per side.
Pasted compare payloads are limited to 2 MB per side.
URL leftValue and rightValue payloads are limited to 100 KB per side.

Site information routes:
/#privacy
/#terms
/#contact
/ads.txt
/status.html

Crawler-friendly tool pages:
/tools/edi.html
/tools/json.html
/tools/xml.html
/tools/delimited.html
/tools/compare.html

Crawler-friendly learn pages:
/learn/edi.html
/learn/json.html
/learn/xml.html
/learn/delimited.html
/learn/compare.html

Machine-readable compare output:
#compare-result-json

Summary selector:
[data-testid="compare-summary-values"]

Diff row selector:
[data-testid="compare-diff-row"]

Useful row attributes:
data-change-type
data-left-line
data-right-line

Important controls:
[data-testid="popular-tool-compare"]
[data-testid="popular-tool-json"]
[data-testid="popular-tool-xml"]
[data-testid="popular-tool-edi"]
[data-testid="popular-tool-delimited"]
[data-testid="tool-tab-compare"]
[data-testid="tool-tab-json"]
[data-testid="tool-tab-xml"]
[data-testid="tool-tab-edi"]
[data-testid="tool-tab-delimited"]
[data-testid="delimited-input"]
[data-testid="delimited-output"]
[data-testid="delimited-input-delimiter"]
[data-testid="delimited-custom-input-delimiter"]
[data-testid="delimited-output-delimiter"]
[data-testid="delimited-custom-output-delimiter"]
[data-testid="delimited-show-column-numbers"]
[data-testid="delimited-zero-based-columns"]
[data-testid="compare-left-input"]
[data-testid="compare-right-input"]
[data-testid="compare-left-path-input"]
[data-testid="compare-right-path-input"]
[data-testid="compare-load-path-drafts"]
[data-testid="compare-load-both"]
[data-testid="compare-save-bat"]
[data-testid="compare-json-diff"]
[data-testid="compare-json-diff-row"]

Recommended agent behavior:
1. Open /#compare with leftValue and rightValue for direct payload comparison.
2. Wait for [data-testid="compare-summary-values"].
3. Parse #compare-result-json for exact counts and row details.
4. Use [data-testid="compare-diff-row"] only when visual row-level inspection is needed.

Example:
/#compare?leftValue=line%201%0Aline%202&rightValue=line%201%0Aline%203

Expected result:
The app reports one changed row and exposes details in #compare-result-json.