Skip to content

Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself. Hosted API + MCP: hyperresearch.ai

3.1 KB
Raw Blame

Selecting sources by scholarly metadata

Use the metadata already stored in your vault to select evidence or find sources that need another check. These filters work with text search and with the MCP search_notes tool. All supplied filters are combined with AND.

# Find matching sources explicitly marked as not retracted, with at least 20 citations.
hpr search "retrieval" --retraction not-retracted --min-citations 20 -j

# Locate a source by its stored DOI (or arXiv ID), without a text query.
hpr search --doi '10.1234/example' -j

# Inspect recovered manuscript versions before using them in a report.
hpr search --oa-version submittedVersion -j

# Find notes whose retraction status has not been checked.
hpr search --retraction unchecked -j
CLI option MCP argument Meaning
--doi doi Exact stored DOI or arXiv ID, case-insensitive
--venue venue Exact stored publication venue, case-insensitive
--min-citations min_citations Known citation count at least this nonnegative number
--retraction retraction retracted, not-retracted, or unchecked
--oa-version oa_version submittedVersion, acceptedVersion, or publishedVersion

not-retracted matches explicit is_retracted: false metadata; an absent status is unchecked, not an assurance. Similarly, --min-citations 0 excludes notes without a known citation count. Citation counts do not establish evidence quality. The Semantic Scholar integration does not fetch retraction data, so its arXiv and DOI fallback results remain unchecked.

oa_version describes the retrieved text, not necessarily the current publication status of the paper. A submitted manuscript may later have been published. Missing version metadata does not match a version filter.

Search results include doi, venue, citation_count, is_retracted (JSON true, false, or null), and oa_version, so agents can inspect the reason a source matched. Omit the text query to browse matching metadata; at least one filter is required. These results are ordered by note creation time, newest first, with ID as the tie-breaker, and support --limit and --offset.

With --semantic, a text query is required and the same filters constrain both keyword and embedding matches before the result limit. Filtering performs no external requests; it uses existing frontmatter metadata. Enrich or update the source notes when fresher metadata is needed.

Existing vaults

The SQLite cache upgrades automatically. Older caches stored unchecked and explicitly false retraction states identically; the upgrade marks these entries unknown and invalidates their sync fingerprints. The next normal sync restores the exact states from Markdown without modifying the source files. If automatic sync is disabled, run hpr sync before relying on the filters. Related claims, embeddings, and links are retained during the upgrade.

Earlier enrichment also wrote false for Semantic Scholar results. Run hpr sources score --fresh to refresh already-scored notes and replace those inferred states with unknown; the cache upgrade alone cannot correct frontmatter.