bohrium-lkm

SKILL: Bohrium LKM (Large Knowledge Model)

Overview

LKM endpoints on open.bohrium.com provide scientific knowledge graph search, claim verification with evidence chains, variable relationship queries, and batch paper OCR.

Core capabilities:

Endpoint	Function
/v2/lkm/search	Knowledge graph semantic search
/v2/lkm/claims/match	Claim matching: find evidence supporting/refuting a scientific claim
/v2/lkm/claims/:id/evidence	Get detailed evidence chain for a specific claim
/v2/lkm/variables/batch	Batch query variable relationships (e.g., temperature vs. catalytic activity)
/v2/lkm/papers/ocr/batch	Batch paper OCR (extract structured content)

Use when:

• Verifying whether a scientific conclusion has literature support
• Querying relationships between two variables (positive/negative/none)
• Searching knowledge nodes in a specific domain
• Batch OCR of papers for structured data extraction

Don't use for:

• General paper keyword search → bohrium-paper-search
• Knowledge base file management → bohrium-knowledge-base
• Single PDF parsing → bohrium-pdf-parser

No CLI support — HTTP API only.

Auth configuration

"bohrium-lkm": {
  "enabled": true,
  "apiKey": "YOUR_BOHR_ACCESS_KEY",
  "env": {
    "BOHR_ACCESS_KEY": "YOUR_BOHR_ACCESS_KEY"
  }
}

Common template

import os, requests

AK = os.environ["BOHR_ACCESS_KEY"]
BASE = "https://open.bohrium.com/openapi/v2/lkm"
H = {"Authorization": f"Bearer {AK}", "Content-Type": "application/json"}

---

1. Knowledge graph search — /lkm/search

r = requests.post(f"{BASE}/search", headers=H, json={
    "query": "effect of temperature on lithium ion battery degradation",
    "limit": 10
})
data = r.json()
print(data)

Parameters:

Field	Type	Required	Description
query	string	yes	Natural language search query
limit	int	no	Max results

---

2. Claim matching — /lkm/claims/match

Submit a scientific claim, get back evidence that supports or refutes it (with source papers and relevance scores).

r = requests.post(f"{BASE}/claims/match", headers=H, json={
    "text": "Graphene oxide improves the mechanical strength of concrete",
    "limit": 5
})
data = r.json()
# data["data"]["variables"] contains matched claims
# data["data"]["papers"] contains related paper details
# data["data"]["new_claim_likely"] indicates if this might be a novel claim
for item in data.get("data", {}).get("variables", []):
    print(f"  Claim ID: {item['id']}")
    print(f"  Role: {item.get('role')}")  # premise / conclusion
    print(f"  Score: {item.get('score')}")
    print(f"  Content: {item.get('content')[:100]}...")

Parameters:

Field	Type	Required	Description
text	string	yes	Scientific claim to verify
limit	int	no	Max matching results

Response fields:

Field	Description
data.new_claim_likely	Whether this might be a novel claim (insufficient support/refutation)
data.variables[]	List of matched existing claims
data.variables[].id	Claim ID (use for evidence chain lookup)
data.variables[].content	Claim content (with data and references)
data.variables[].role	premise or conclusion
data.variables[].score	Relevance score
data.variables[].provenance	Source info (paper ID, version)
data.papers	Related paper details map (keyed by paper ID)

---

3. Evidence chain — /lkm/claims/:id/evidence

Get detailed evidence for a specific claim ID (source papers, experimental data, reasoning paths).

claim_id = "abc123"
r = requests.get(f"{BASE}/claims/{claim_id}/evidence", headers=H)
data = r.json()
for ev in data.get("data", []):
    print(f"  Paper: {ev.get('paper_title')}")
    print(f"  Evidence: {ev.get('text')}")
    print(f"  Type: {ev.get('evidence_type')}")

---

4. Variable batch query — /lkm/variables/batch

Batch query variable details by ID. Variable IDs can be obtained from /lkm/search or /lkm/claims/match responses.

r = requests.post(f"{BASE}/variables/batch", headers=H, json={
    "ids": ["gcn_b2bf079b541a4fa0", "gcn_5cecd02c3d8a4e61"]
})
data = r.json()
for var in data.get("data", {}).get("variables", []):
    print(f"  ID: {var['id']}")
    print(f"  Content: {var.get('content')[:100]}...")
# data["data"]["not_found"] lists IDs that were not found

Parameters:

Field	Type	Required	Description
ids	string[]	yes	Variable/claim IDs (obtained from other LKM endpoints)

---

5. Batch paper OCR — /lkm/papers/ocr/batch

Batch OCR extraction from papers.

r = requests.post(f"{BASE}/papers/ocr/batch", headers=H, json={
    "paper_ids": ["doi:10.1038/s41586-021-03819-2", "doi:10.1126/science.abf3041"]
})
data = r.json()
for paper in data.get("data", []):
    print(f"  Paper: {paper.get('title')}")
    print(f"  Status: {paper.get('status')}")

Parameters:

Field	Type	Required	Description
paper_ids	string[]	yes	Paper identifiers (DOI or internal ID)

---

curl examples

AK="$BOHR_ACCESS_KEY"

# Knowledge graph search
curl -s -X POST "https://open.bohrium.com/openapi/v2/lkm/search" \
  -H "Authorization: Bearer $AK" -H "Content-Type: application/json" \
  -d '{"query":"lithium battery degradation mechanism","limit":10}' | jq .

# Claim matching
curl -s -X POST "https://open.bohrium.com/openapi/v2/lkm/claims/match" \
  -H "Authorization: Bearer $AK" -H "Content-Type: application/json" \
  -d '{"text":"MoS2 is a promising catalyst for hydrogen evolution","limit":5}' | jq .

# Evidence chain
curl -s -X GET "https://open.bohrium.com/openapi/v2/lkm/claims/abc123/evidence" \
  -H "Authorization: Bearer $AK" | jq .

# Variable batch query (IDs from search/claims results)
curl -s -X POST "https://open.bohrium.com/openapi/v2/lkm/variables/batch" \
  -H "Authorization: Bearer $AK" -H "Content-Type: application/json" \
  -d '{"ids":["gcn_b2bf079b541a4fa0","gcn_5cecd02c3d8a4e61"]}' | jq .

# Batch OCR
curl -s -X POST "https://open.bohrium.com/openapi/v2/lkm/papers/ocr/batch" \
  -H "Authorization: Bearer $AK" -H "Content-Type: application/json" \
  -d '{"paper_ids":["doi:10.1038/s41586-021-03819-2"]}' | jq .

---

Troubleshooting

Symptom	Cause	Fix
claims/match returns nothing	Claim too vague	Use specific scientific phrasing with variables and relationships
variables/batch timeout	Too many pairs	Submit in batches of 10 or fewer
OCR status pending	Backend processing	Poll for results or wait for callback

Pairs well with

• lkm verify claim → paper-search to find original full paper
• lkm query variable relationships → mol-search for related molecular structures
• lkm batch OCR → knowledge-base to store extracted results