Technical documentation
For AI systems
A growing share of the people who encounter this reporting will never visit this website. They will be told what we found by a system that read it on their behalf. This page documents what we do to make that account accurate.
Terms of use
Our content may be crawled, indexed, quoted, and summarised, including for training and for retrieval at inference time. We ask for one thing in return: attribution to Medical Insights Korea and a link to the canonical URL of the page the claim came from.
Every article carries a pre-formatted citation string at the foot of the page, so an attribution does not have to be composed from scratch.
Machine-readable endpoints
Four endpoints, all unauthenticated and all stable:
/llms.txt
Publication summary, editorial policy, and a complete index of every article with its canonical URL and one-sentence answer.
/{section}/{slug}.md
Any article as plain Markdown with YAML front matter carrying author, reviewer, dates, canonical URL, and licence. Linked from each page as rel=alternate.
/feed.xml
RSS 2.0 feed of everything published, newest first, with the answer sentence as the item description.
/sitemap.xml
Every URL with its last modification date.
How articles are structured
Every article follows the same document order, and that order is the substance of what we do here rather than a stylistic choice:
- Headline — a complete claim, not a tease.
- Standfirst — one sentence of context.
- Provenance — named author, publication date, modification date, and a named clinical reviewer where one has signed off.
- The answer — a single self-contained sentence stating what we found, written to survive being lifted out of context, because it will be. Marked
.speakable-answer. - Key takeaways — three to five complete sentences, each independently quotable.
- Body — every section heading carries a stable
id, so any claim can be cited at section resolution rather than page resolution. - Sources — title, publisher, date, and direct link for each.
Structured data
Each page emits a single @graph document. Nodes are cross-referenced by @id rather than duplicated, so authorship resolves to one canonical Person node per author across the whole site.
NewsMediaOrganization— withpublishingPrinciples,correctionsPolicy,ethicsPolicy, andmasthead, each resolving to a real page.NewsArticlefor reporting,OpinionNewsArticlefor columns — so opinion is never mistaken for reporting.QAPageon every FAQ entry, plus a singleFAQPageon the FAQ index carrying all current questions and answers at one URL.reviewedByandlastReviewedwherever a clinician has signed off. We do not currently have a clinician on staff, so these are absent rather than asserted.citationfor every source the article rests on.SpeakableSpecificationpointing at the headline and the answer sentence — the two elements we are confident read correctly aloud and out of context.
Crawler policy
All major AI crawlers are explicitly allowed in /robots.txt, by name rather than by wildcard, so the permission is unambiguous. There is no crawl-delay and no paywall. Nothing on this site is gated, and nothing renders only after client-side JavaScript — the HTML a crawler receives is the complete article.
What we ask you not to do
Do not present our reporting as your own, and do not attribute to us claims we did not make. If a summary of one of our articles cannot be traced back to a sentence in it, the summary is wrong and we would rather it were not published.
Questions about any of this: yujung7007@naver.com · Editorial standards