# Pheonix Research

> Market intelligence and research content with structured schema and graph exports.

## Discovery
- Canonical site: https://www.pheonixresearch.com/
- Machine discovery JSON: https://www.pheonixresearch.com/.well-known/pheonix-discovery.json
- Well-known llms mirror: https://www.pheonixresearch.com/.well-known/llms.txt
- Primary sitemap: https://www.pheonixresearch.com/sitemap.xml

## Supported machine endpoints
- Discovery JSON: https://www.pheonixresearch.com/.well-known/pheonix-discovery.json
- Graph snapshot: https://graph.pheonixresearch.com/api/v1/read/live/graph
- Graph exclusions: https://graph.pheonixresearch.com/api/v1/read/live/exclusions
- Graph meta: https://graph.pheonixresearch.com/api/v1/read/live/meta
- Graph bundle: https://graph.pheonixresearch.com/api/v1/read/live/bundle
- Primary llms: https://www.pheonixresearch.com/llms.txt
- Well-known llms: https://www.pheonixresearch.com/.well-known/llms.txt

## Supported discovery flow
1. Fetch discovery JSON.
2. Fetch the Graph Service graph snapshot or graph bundle for global traversal.
3. Fetch page HTML for page-scoped JSON-LD.
4. Use sitemaps only for URL discovery.

## Public machine-readable resources
- Graph snapshot: https://graph.pheonixresearch.com/api/v1/read/live/graph
- Graph exclusions: https://graph.pheonixresearch.com/api/v1/read/live/exclusions
- Graph meta: https://graph.pheonixresearch.com/api/v1/read/live/meta
- Graph bundle: https://graph.pheonixresearch.com/api/v1/read/live/bundle
- Graph Service health: https://graph.pheonixresearch.com/api/v1/health
- Industry sitemap: https://www.pheonixresearch.com/industry-sitemap.xml
- Segment sitemap: https://www.pheonixresearch.com/segment-sitemap.xml
- Market report sitemap: https://www.pheonixresearch.com/market-report-sitemap.xml
- Press release sitemap: https://www.pheonixresearch.com/press-release-sitemap.xml

## Unsupported assumptions
- No public wp-json graph API is exposed.
- No ?format=json endpoint is exposed for page URLs.
- No per-fragment fetch endpoints exist for #dataset, #faq, #intelligence, #webpage, or other JSON-LD fragment IDs.
- Fragment IDs are in-page JSON-LD identifiers, not separate HTTP resources.

## Notes
- HTML pages remain the canonical public source.
- JSON-LD is emitted in page HTML and in the global head graph.
- Discovery JSON is the machine entrypoint for bots and automated clients.
- Graph snapshot reads are now served by Graph Service, not from plugin-local public endpoints.

## Markdown surface (.md alternate for each page)
- Every eligible Phoenix node has a .md alternate URL at {canonical_url_without_trailing_slash}.md
- Example market-report: https://www.pheonixresearch.com/{industry}/{segment}/market-report/{slug}.md
- Example segment: https://www.pheonixresearch.com/{industry}/{segment}.md
- Example industry: https://www.pheonixresearch.com/{industry}.md
- Content-Type: text/markdown
- Structure: YAML frontmatter (node identity + schema + ACF fields + graph refs) + markdown body
- Eligibility gate: post must have a non-null mi_node_id in wp_phoenix_page_identity_registry
- Not indexed: X-Robots-Tag: noindex, noarchive, nosnippet on all .md responses
- Canonical injection: .md response includes Link: <HTML_URL>; rel="canonical" (equity points to HTML page)

## Per-page response headers (for eligible Phoenix node pages)
- Link: <{page}.md>; rel="alternate"; type="text/markdown" — markdown alternate for this page
- X-Pheonix-Node-Id: {MI_ID} — the MI identity of this page
- Link: <https://graph.pheonixresearch.com/api/v1/query/live/node/{MI_ID}>; rel="describedby"; type="application/json" — direct graph node query for this page