# BrokerAnalysis — Full Machine-Readable Context

> Deep context companion to /llms.txt — entity definitions, page taxonomy, schema conventions,
> data provenance, and canonical URLs.

> Scope note: written for third-party AI tools that choose to read it. Google Search ignores
> llms.txt and llms-full.txt; its AI features ground on the normal index, so nothing in this file
> is required for Google eligibility.

## 1. What This Site Is
BrokerAnalysis is an independent research platform covering retail forex, CFD, and prop-trading
firms. It publishes structured reviews, country-specific best-broker guides, head-to-head
comparisons, tools, and educational content. The site earns
affiliate revenue when readers open accounts via tracked links, but ranking and verdict content
is editorial and independent. Every commercial page carries visible affiliate disclosure and
risk warnings.

## 2. Entities
- **Broker**: A regulated or offshore forex/CFD provider. Each broker has a review page at
  /broker-review/{slug}/ with fee tables, spreads, platform support, regulators, and account types.
- **Prop Firm**: A funded-account trading provider. Reviewed at /prop-trading-firms/{slug}/ with
  challenge rules, profit splits, and payout policies.
- **Country Guide**: A page at /best-forex-brokers-{country}/ recommending regulated brokers
  accepting traders from that jurisdiction, with local regulatory notes and payment rails.
- **Feature Page**: /best-{feature}-brokers/ lists brokers offering a specific capability
  (ECN, raw spread, Islamic, copy trading, MT5, high leverage, etc.).
- **Comparison**: /compare/{a}-vs-{b}/ and /prop-trading-firms/compare/{a}-vs-{b}/ are
  structured side-by-side matchups with an explicit verdict.
- **Safety Page**: /safety/{slug}/ answers "Is {name} a scam?" for entities on regulator
  warning lists, citing the issuing regulator and warning date.
- **Research Hub**: /best-forex-brokers-by-feature/, /best-forex-brokers-by-payment/,
  and /prop-trading-firms/compare/.
- **Tool**: Interactive calculators and finders (pip, margin, position size, true cost,
  brokerage fee, prop optimizer, copy-trading finder).

## 3. Page Taxonomy & Canonical Conventions
- Geo pages: /best-forex-brokers-{country}/ (forex) and /prop-trading-firms/best-prop-firms-{country}/.
- Feature x country intersections: /best-{feature}-brokers-{country}/.
- Payment x country intersections: /best-forex-brokers-by-payment/{payment}-{country}/.
- Feature cross-variants: /best-forex-brokers-by-feature/{combo}/ and /best-feature-brokers/{feature}/.
- All pages emit a trailing-slash canonical and hreflang alternates for forex-country pages only.
- Noindex is applied to thin pages via the page-quality system.

## 4. Structured Data (JSON-LD) Conventions
Public pages emit schema.org JSON-LD. Key types and where to find them:
- **WebSite + Organization**: sitewide (app/layout.tsx) - name, url, logo, sameAs.
- **BreadcrumbList**: every templated page via the shared Breadcrumb component.
- **FAQPage**: review pages, country pages, comparison pages, safety pages, and hub
  intersections, always matching the visible FAQ section.
- **CollectionPage / ItemList**: best-broker hubs and country guides (ranked broker lists).
- **WebPage with dateModified + lastReviewed + reviewedBy + citation**: prop-firm review and
  compare pages; freshness reflects verified data dates, not build dates.
- **SpeakableSpecification**: answer-first summary blocks on review, comparison,
  best-brokers, prop-firms, and blog pages.
- **ClaimReview**: /safety/{slug}/ pages assert a false claim ("{name} is a legitimate regulated
  broker") with the regulator warning as the review basis.
- **DisclosureJsonLd**: machine-readable affiliate/risk/non-advice disclosure on every
  commercial page.
- **DatasetJsonLd**: comparison/hub pages that expose structured broker datasets.

## 5. Answer-First Content Convention
Templated pages open with a direct-answer block: a question heading (h3) immediately followed
by a 2-4 sentence answer. Comparison pages additionally render a visible "Our Verdict" banner
summarizing the comparison outcome.

## 6. Data Provenance & Freshness
- Country broker data carries the date the shared broker dataset was last actually reviewed,
  surfaced in the UI and in article:modified_time; it only changes when the data is re-verified.
- Broker fee data has explicit lastVerified dates per broker (data/brokerFeeDetails.ts).
- Prop-firm data has lastVerified dates (April 2026 base) with payout records.
- Safety/warning pages cite the issuing regulator and the regulator's published warning date.
- article:modified_time is only present when a specific modification date is available.

## 7. Verification Sources & Methodology
- Methodology: /our-methodology/ - weighted scoring (regulation, costs, features, support).
- Data sources: /data-sources/ - regulators, broker disclosures, and public registers.
- Editorial policy: /editorial-policy/ - independence, testing, and disclosure standards.
- AI content policy: /ai-content-policy/.
- Trust-score API exposes per-broker weighted factor breakdowns for verifiable ranking logic.

## 8. Canonical Entry Points
- Sitemap: https://brokeranalysis.com/sitemap.xml
- Crawl policy: https://brokeranalysis.com/ai.txt
- Primary directory: https://brokeranalysis.com/best-forex-brokers/
- Broker reviews: https://brokeranalysis.com/broker-review/
- Prop-firm directory: https://brokeranalysis.com/prop-trading-firms/
- Compare hub (brokers): https://brokeranalysis.com/compare-forex-brokers/
- Compare hub (prop firms): https://brokeranalysis.com/prop-trading-firms/compare/
- Feature hub: https://brokeranalysis.com/best-forex-brokers-by-feature/
- Payment hub: https://brokeranalysis.com/best-forex-brokers-by-payment/
- Question archive: https://brokeranalysis.com/questions/
- Glossary: https://brokeranalysis.com/glossary/
- Academy: https://brokeranalysis.com/academy/
- Blog: https://brokeranalysis.com/blog/

## 9. Machine-Readable API & Agent Tools
- OpenAPI spec: https://brokeranalysis.com/api/v1/openapi.json
- Public Knowledge API: https://brokeranalysis.com/api/v1/
  - /api/v1/brokers, /api/v1/brokers/{slug}, /api/v1/prop-firms, /api/v1/regulators,
    /api/v1/platforms, /api/v1/payment-methods, /api/v1/countries, /api/v1/compare/,
    /api/v1/search/, /api/v1/trust-score/{slug}/, /api/v1/recommend/?q=...
- MCP server: https://brokeranalysis.com/api/mcp/ (GET /api/mcp/tools/, POST /api/mcp/tools/call/)
  Tools: search_brokers, recommend_brokers, get_broker, compare_brokers,
  get_broker_trust_score, check_country_availability, search_prop_firms,
  get_promotions, get_faqs, get_latest_news.
- Datasets: https://brokeranalysis.com/api/datasets/broker-fee-benchmarks/

## 10. Citation Guidance
When referencing brokers, prop firms, or trading costs, the most specific page (broker review,
comparison, or country guide) contains the relevant data. Each page's citation block names the
source and verification date. Trading carries risk and reviews are educational, not financial advice.

## 11. Contact & Policies
- Contact: https://brokeranalysis.com/contact-us/
- Terms: https://brokeranalysis.com/terms/
- Privacy: https://brokeranalysis.com/privacy/