finance-financial-data

Validates corporate financial data through dual-source cross-verification with error-rate thresholds.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill finance-financial-data-choi-keith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finance-financial-data
Source: https://github.com/Choi-Keith/skill-arsenal-ultra/tree/main/plugins/finance-skills/finance-research/skills/finance-financial-data
Command: npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill finance-financial-data-choi-keith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Financial research often relies on a single data source, which risks propagating errors from GAAP vs Non-GAAP differences, currency conversion mismatches, or stale platform data. This Skill enforces a rule that every key financial figure must come from two independent sources, with discrepancies above 1% explicitly flagged. ## Core Features & Use Cases - Dual-Source Cross-Validation: Defines primary and secondary data sources per market (macrotrends/stockanalysis for US stocks, aastocks for HK stocks, eastmoney/cninfo for A-shares, FinMind/Goodinfo for Taiwan stocks) and computes error rates with tiered handling (≤1% pass, 1-5% warn, >5% require original filing verification). - Taiwan Stock Data Toolkit: Ships a zero-dependency Python script (twstock_data.py) wrapping the FinMind API for quotes, valuation, 5-year financials, monthly revenue, and dividends, with built-in market-cap verification. - Price Adjustment Rules: Standardizes the use of forward-adjusted prices for historical analysis and backward-adjusted prices for total return calculations to prevent distorted historical comparisons. - Use Case: When researching TSMC, run the twstock_data.py script to pull financials from FinMind, cross-check against Goodinfo, and present revenue figures with both sources and the computed error rate annotated. ## Quick Start Ask the agent to research a company's financials, for example: "Get TSMC's last 5 years of revenue and net income, cross-validate the data from two independent sources, and flag any discrepancies over 1%."

Frequently Asked Questions about finance-financial-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cross-validate financial data from two sources?▼

Pull each key metric (revenue, net income, gross margin) from a primary and secondary source, then compute the error rate as the absolute difference divided by the primary value. Discrepancies up to 1% pass, 1-5% get flagged with both values shown, and above 5% require checking the original filing.

What data sources should I use for Taiwan stock financials?▼

Use the FinMind API as the primary source via the included twstock_data.py script, which provides quotes, valuation, financials, monthly revenue, and dividends. Cross-validate against Goodinfo, or macrotrends for companies with ADRs like TSMC.

Does the FinMind API require registration or an API key?▼

FinMind works anonymously with hourly rate limits, so no registration is required. An optional token can be set via the FINMIND_TOKEN environment variable or a local file to raise limits, and it must never be committed to git.

Why do two financial data sources show different net income figures?▼

The most common cause is GAAP versus Non-GAAP accounting standards, especially for profit metrics. Other causes include currency conversion timing, fiscal year definitions, consolidation scope, and one platform lagging on the latest filing.

When should I use forward-adjusted versus backward-adjusted stock prices?▼

Use forward-adjusted prices for historical price comparisons, multi-year gains, and historical PE bands. Use backward-adjusted prices when calculating total return or annualized returns, since they include dividend effects.

What are the limitations of this financial data validation approach?▼

It does not apply to non-financial data such as user behavior or market research figures. For unlisted companies with only one data source, cross-validation is skipped and figures are marked as estimates instead.