vendor-verification

name	vendor-verification
description	Verify whether vendors/merchants from expense records are real, registered business entities by querying the free Wikidata open API.

Vendor Verification

Verify whether merchants or vendors from expense records are real, registered business entities by querying the free, open Wikidata API (no key required). This skill helps identify potentially fraudulent or unverified merchants.

Embedded Script

python3 skills/vendor-verification/scripts/verify_vendors.py --workspace .agents/workspace

Arguments

Argument	Default	Description
--workspace	.agents/workspace	Workspace directory containing expenses.csv or reconciliation_data.json

What it does

1. Loads expense records from .agents/workspace/reconciliation_data.json (if available from a prior reconciliation run) or directly from .agents/workspace/expenses.csv.
2. Identifies all unique vendor/merchant names.
3. For each unique merchant, queries the free Wikidata Entity Search API: https://www.wikidata.org/w/api.php?action=wbsearchentities&search={merchant_name}&language=en&format=json
4. Analyzes the search results:
   • Verified: If a matching entity exists on Wikidata. Extracts the description (e.g. “American multinational technology company”) and entity ID (e.g., Q95).
   • Unverified: If no match is found on Wikidata.
5. Generates .agents/workspace/vendor_verification_report.md with: