Claimora

Use this when you have a claim id and need the people linked to it.
Returns author id, name, and orcid. The list is empty when none are linked.
Example: get_authors(claim_id="claim-attention").
Example: get_authors(claim_id="<id from query_claims>").

Returns each opposing claim id, status, evidence strength, and opposition strength.
Example: get_contradictions(claim_id="<id from query_claims>").

unpublished is true for a private unpublished paper. The stored excerpt, page, and section stay on provenance. An empty provenance doi is filled from a DOI already stored on that row, including the DataCite DOI of an arXiv id. The graph is not written.
status_note on a consensus claim with no stored contradiction is: No stored contradiction; not independent multi-source consensus. When no independent supporting claim is present, the note also says: Single-source claim; not multi-source consensus.
evidence_note is: Extractor confidence in the claim statement, not study quality. A previously read source role is appended when one is known. When that role is absent, one statement cue appends a single Role line. A clear finding is not labeled method or background, a hedge is a limitation, and a statement with no cue has no Role line.
integrity_warning is set when the statement unit looks truncated relative to the excerpt, or the magnitude looks extreme relative to the excerpt. The statement and the excerpt are not rewritten.
Use this after a search when you have a claim id and need the papers behind it.
Example: get_evidence(claim_id="claim-attention").
Example: get_evidence(claim_id="claim-attention", full_text=true).

Use this when you want links between claims rather than the claims themselves.
Pass claim_id to navigate from one claim to the flags that contain it. Each hit includes flag_type, strength, summary, the other claim ids, and those claims' primary domains. Filters are flag_type, min_strength, and cross_domain_only. The claim list is ranked by relationship strength and novelty. A path that only names the claim, a partner that repeats the claim, and a near-duplicate of a partner already returned are omitted.
Discovery combines relationship strength, novelty, and conceptual overlap. A near-copy, a stock template, a lexical basis, or flag_type lexical or lexical_association is left off the default strength and discovery lists. The stored row is not changed. A claim_id lookup still returns that flag. flag_type lexical or lexical_association still returns that class. sort strength orders by the stored relationship strength.
Every flag includes flag_type, cross_domain, complementary, and summary. summary says why the claims are linked. A lexical relationship_basis adds “Shared vocabulary only. No substantive mechanism was established.” on read. The stored summary is not rewritten.
complementary is a ranking hint when two independent sources share a measurable variable or process and discuss different aspects. It reuses relationship_basis, does not change flag_type, and does not state a hypothesis. A weak link stays weak.
flag_type is lexical_association for shared terminology with no substantive relation, scientific_connection for a conceptual or methodological relationship, contradiction for a stored disagreement, or innovation when the claims state a mechanism that could transfer. lexical selects the same weak rows.
cross_domain is true when the claims have different primary domains. It is not a flag_type and does not raise strength.
Older rows may still use cross_domain or research_hypothesis.
strength is computed for that pair. It is not claim evidence strength. A weak lexical link stays low. min_strength 0 does not put it back on the default lists.
Returns flag id, domain, summary, strength, flag_type, cross_domain, connected_domain, the claim ids on each path, and a claims array in that same order.
Each claims item has claim_id, statement, and evidence strength. Full evidence stays on get_evidence.
connected_domain is the primary domain of the claim that does not match the flag domain.
It is null when the claims share a primary domain.
Optional cross_domain_only, when true, returns only flags whose connected_domain is set.
Optional flag_type keeps one label, for example lexical.
Optional sort is discovery or strength. discovery is the default.
Repeated claim paths return once, keeping the strongest flag for that pair.
Example: get_innovation_flags(domain="ai-ml", min_strength=0.5, limit=10).
Example: get_innovation_flags(domain="ai-ml", sort="strength", limit=10).
Example: get_innovation_flags(claim_id="claim-attention", min_strength=0.5, limit=10).
Example: get_innovation_flags(domain="quantum", min_strength=0, flag_type="lexical", limit=5).
Example: get_innovation_flags(domain="consciousness", cross_domain_only=True, limit=10).

Use this to read claims that changed after a time you already checked.
Returns claim id, status, evidence strength, a shortened excerpt, and source_url, doi, and paper_id when those are known.
Example: get_updates(since="2026-01-01T00:00:00Z", domain="ai-ml", limit=20).
Example: get_updates(since="2026-10-01T00:00:00Z", domain="consciousness", offset=20).

A domain keeps claims whose primary domain is that value or one of its
aliases, such as cs.LG for ai-ml. An exact multi-token phrase matches whole
tokens. A single ordinary token also matches its singular or plural.
When no stored claim holds every token, statement hits for each token come
before excerpt-only hits, a row with no content-term overlap is dropped,
and match_reason starts with no stored co-occurrence. An empty remainder stays empty.
K17, PDAC, NCC, IIT, and LLM match the full names in the alias map.
Hits are ordered by keyword overlap, then a domain match, then evidence
strength. That retrieval order stays ahead of the stored score.
match_reason records that the stored score is evidence_strength.
cross_domain also keeps
claims from other domains that carry the domain as a secondary tag.
When the query is one domain keyword and domain is omitted, claims in
that domain come first.

Use this when you have keywords or a domain and want the strongest matching claims.
Returns claim id, status, evidence strength, a shortened excerpt, match_reason,
source_url, doi, and paper_id when those are known, up to two supporting claims, and one
contradicting claim when one is stored. Each related claim carries that same compact pointer. unpublished is true for a private unpublished paper. Full provenance stays on get_evidence.
status_note on a consensus claim with no stored contradiction is: No stored contradiction; not independent multi-source consensus. When no independent supporting claim is present, the note also says: Single-source claim; not multi-source consensus.
evidence_note is: Extractor confidence in the claim statement, not study quality. A previously read source role is appended when one is known. When that role is absent, one statement cue appends a single Role line. A clear finding is not labeled method or background, a hedge is a limitation, and a statement with no cue has no Role line.
integrity_warning is set when the statement unit looks truncated relative to the excerpt, or the magnitude looks extreme relative to the excerpt. The statement and the excerpt are not rewritten.
Example: query_claims(query="transformer", domain="ai-ml", limit=5).
Example: query_claims(query="United States", domain="data-protection", limit=5).

The central research concept and its scientific synonyms outrank incidental context words. Generic overlap that does not address the question is penalized. A keyword with no function word stays on the lexical match.
A question tries its content phrases first. When that match is thin, extracted concepts, shorter phrases, and synonyms are combined and deduplicated before ranking. Exact keywords are not required.
Question hits stay on strategy question. fallback is null when the content-phrase match already addressed the concept, keyword when every hit came from a literal concept or shorter phrase, and expanded when a synonym supplied a hit. Rank puts the concept above context words. Retrieval relevance stays ahead of evidence_strength, and match_reason records that the stored score is evidence_strength. A lexical phrase matches whole tokens. K17, PDAC, NCC, IIT, and LLM match the full names in the alias map.
notice is no_matching_claims when nothing matches. notice is no_evidence when every returned hit has an empty excerpt. A hit with an empty excerpt says no evidence in match_reason.
exploratory true keeps matches under the default relevance threshold.
Each hit includes match_reason, source_url, doi, and paper_id when those are known, up to two supporting claims, and one contradicting claim when one is stored. Each related claim carries that same compact pointer. unpublished is true for a private unpublished paper. Full provenance stays on get_evidence.
status_note on a consensus claim with no stored contradiction is: No stored contradiction; not independent multi-source consensus. When no independent supporting claim is present, the note also says: Single-source claim; not multi-source consensus.
evidence_note is: Extractor confidence in the claim statement, not study quality. A previously read source role is appended when one is known. When that role is absent, one statement cue appends a single Role line. A clear finding is not labeled method or background, a hedge is a limitation, and a statement with no cue has no Role line.
integrity_warning is set when the statement unit looks truncated relative to the excerpt, or the magnitude looks extreme relative to the excerpt. The statement and the excerpt are not rewritten.

A domain keeps claims whose primary domain is that value or one of its
aliases. cross_domain also keeps claims from other domains that carry
the domain as a secondary tag.

Use this when the input is a question instead of keywords.
Example: search_smart(natural_language="How do transformers handle long context?", domain="ai-ml", limit=5).
Example: search_smart(natural_language="What causes LLM hallucinations in RAG systems?", limit=5).