npm - ai4scholar - Versions diffs - 0.3.1 → 0.3.3 - Mend

ai4scholar 0.3.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +144 -82
package/dist/src/tools/quality-rank.d.ts +1 -1
package/dist/src/tools/quality-rank.js +1 -1
package/dist/src/tools/quality-rank.js.map +1 -1
package/docs/tutorial.md +329 -0
package/package.json +2 -1

package/README.md CHANGED Viewed

@@ -6,24 +6,97 @@ Powered by [ai4scholar.net](https://ai4scholar.net).
 ## What It Does
-AI4Scholar gives OpenClaw direct access to 6 academic platforms through 17 built-in tools, plus a literature survey skill that generates rich HTML reports.
-### Platforms & Tools
-| Platform | Tools | Via |
-|----------|-------|-----|
-| **Semantic Scholar** | `search_semantic`, `get_semantic_paper_detail`, `get_semantic_citations`, `get_semantic_references`, `search_semantic_authors`, `get_semantic_author_papers`, `get_semantic_recommendations`, `get_semantic_recommendations_for_paper`, `search_semantic_snippets` | ai4scholar.net |
-| **PubMed** | `search_pubmed`, `get_pubmed_paper_detail`, `get_pubmed_citations`, `get_pubmed_related` | ai4scholar.net |
-| **Google Scholar** | `search_google_scholar` | ai4scholar.net |
-| **arXiv** | `search_arxiv` | Direct API |
-| **bioRxiv** | `search_biorxiv` | Direct API |
-| **medRxiv** | `search_medrxiv` | Direct API |
+AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** through **35 built-in tools**, plus 2 agent skills for literature surveys and automatic citation annotation.
+### Platforms
+| Platform | Coverage |
+|----------|----------|
+| **Semantic Scholar** | 200M+ papers across all fields |
+| **PubMed** | Biomedical & life sciences |
+| **Google Scholar** | Broad academic search |
+| **arXiv** | Physics, CS, math, biology preprints |
+| **bioRxiv** | Biology preprints |
+| **medRxiv** | Health sciences preprints |
+### Tools (35)
+**Search (9)**
+| Tool | Platform | Description |
+|------|----------|-------------|
+| `search_semantic` | Semantic Scholar | Search papers with year filtering |
+| `search_pubmed` | PubMed | Biomedical papers, date range + sorting |
+| `search_google_scholar` | Google Scholar | Broad academic search via ai4scholar proxy |
+| `search_arxiv` | arXiv | Preprints search |
+| `search_biorxiv` | bioRxiv | Biology preprints by category + date |
+| `search_medrxiv` | medRxiv | Health preprints by category + date |
+| `search_semantic_snippets` | Semantic Scholar | Full-text snippet search (~500 word excerpts) |
+| `search_semantic_bulk` | Semantic Scholar | Bulk search, up to 1000 results with pagination |
+| `search_semantic_paper_match` | Semantic Scholar | Exact title matching |
+**Paper Details & Batch (4)**
+| Tool | Description |
+|------|-------------|
+| `get_semantic_paper_detail` | Paper metadata by ID (DOI, arXiv ID, PMID, etc.) |
+| `get_pubmed_paper_detail` | PubMed paper metadata by PMID |
+| `get_semantic_paper_batch` | Batch paper details (up to 500) |
+| `get_pubmed_paper_batch` | Batch PubMed details |
+**Citations & References (4)**
+| Tool | Description |
+|------|-------------|
+| `get_semantic_citations` | Papers citing the given paper |
+| `get_semantic_references` | Papers referenced by the given paper |
+| `get_pubmed_citations` | PubMed citation lookup |
+| `get_pubmed_related` | PubMed related papers |
+**Authors (5)**
+| Tool | Description |
+|------|-------------|
+| `search_semantic_authors` | Search authors by name |
+| `get_semantic_author_detail` | Author profile (h-index, papers, citations) |
+| `get_semantic_author_papers` | All papers by an author |
+| `get_semantic_author_batch` | Batch author details (up to 1000) |
+| `get_semantic_paper_authors` | All authors of a paper |
+**Recommendations (2)**
+| Tool | Description |
+|------|-------------|
+| `get_semantic_recommendations` | Recommend papers from positive/negative examples |
+| `get_semantic_recommendations_for_paper` | Similar papers for a single paper |
+**PDF Download & Full-Text Reading (10)**
+| Tool | Description |
+|------|-------------|
+| `download_semantic` | Open access PDF URL from Semantic Scholar |
+| `read_semantic_paper` | Download + extract full text (Semantic Scholar) |
+| `download_arxiv` | arXiv PDF URL |
+| `read_arxiv_paper` | Download + extract full text (arXiv) |
+| `download_biorxiv` | bioRxiv PDF URL |
+| `download_medrxiv` | medRxiv PDF URL |
+| `read_biorxiv_paper` | Download + extract full text (bioRxiv) |
+| `read_medrxiv_paper` | Download + extract full text (medRxiv) |
+| `download_by_doi` | Download PDF by DOI (supports institutional access) |
+| `read_by_doi` | Download + extract full text by DOI |
+**Quality Evaluation (1)**
+| Tool | Description |
+|------|-------------|
+| `paper_quality_rank` | Rank papers by CCF classification, citations, year, h-index |
 ### Skills
 | Skill | Description |
 |-------|-------------|
-| **literature-survey** | Structured literature survey with fulltext search, HTML report + CSV generation, or multi-source review |
+| **literature-survey** | Multi-source literature survey with HTML report generation |
+| **auto-cite** | Automatically add citation markers and reference list to academic text |
 ### Slash Commands
@@ -33,22 +106,6 @@ AI4Scholar gives OpenClaw direct access to 6 academic platforms through 17 built
 | `/projects` | List all literature projects |
 | `/reading-list` | Show the reading list |
-### Report Generation
-The plugin includes Python scripts for generating rich HTML reports from fulltext search results:
-- **6 color themes** (Light, Sepia, Dark, Green, Pink, Perplexity)
-- Interactive snippet cards with modal detail views
-- Filtering by source type, year, venue, and keyword
-- Automatic title translation (Chinese ↔ English)
-- CSV data export
-## Prerequisites
-- [OpenClaw](https://github.com/openclaw/openclaw) installed and running
-- An [ai4scholar.net](https://ai4scholar.net) API key (for Semantic Scholar, PubMed, and Google Scholar tools)
-- Python 3.8+ with `requests` (for HTML report generation)
 ## Install
 ### From npm (recommended)
@@ -57,101 +114,106 @@ The plugin includes Python scripts for generating rich HTML reports from fulltex
 openclaw plugins install ai4scholar
 ```
-The plugin installs to `~/.openclaw/extensions/ai4scholar/` and is automatically enabled.
+After installation, **restart the gateway**:
+```bash
+openclaw gateway
+```
 ### From source (development)
 ```bash
 git clone https://github.com/literaf/ai4scholar.git
-cd ai4scholar && pnpm install && pnpm build
-# Link as dev plugin
-pnpm dev:link
-# or equivalently:
+cd ai4scholar
+pnpm install
+pnpm build
 openclaw plugins install -l .
 ```
-### Verify installation
+### Verify
 ```bash
 openclaw plugins list
 # Should show: ai4scholar (enabled)
 ```
-After installation, **restart the gateway** to load the plugin:
+## Configuration
-```bash
-# Stop the running gateway (Ctrl+C), then:
-openclaw gateway
-```
-### Configuration
-After installation, set your API key in OpenClaw's plugin settings (WebUI):
-- **AI4Scholar API Key** — get one at [ai4scholar.net/dashboard](https://ai4scholar.net/dashboard?view=api-keys)
-### Optional: External MCP Server
-For additional capabilities, you can also configure the [ai4scholar-mcp](https://github.com/literaf/ai4s-mcp) server in `~/.openclaw/openclaw.json`:
+Set your API key in `openclaw.json`:
 ```json
 {
-  "mcpServers": {
-    "ai4scholar": {
-      "url": "https://mcp.ai4scholar.net/sse",
-      "headers": {
-        "Authorization": "Bearer <your-api-key>"
+  "plugins": {
+    "entries": {
+      "ai4scholar": {
+        "enabled": true,
+        "config": {
+          "apiKey": "<your-api-key>"
+        }
       }
     }
   }
 }
 ```
+Get your API key at [ai4scholar.net/dashboard](https://ai4scholar.net/dashboard?view=api-keys).
 ## Usage
-Just talk to your OpenClaw assistant:
+Just talk to your OpenClaw agent:
+```
+Search for recent papers on CRISPR in cancer immunotherapy
+```
 ```
-Search for recent papers on transformer-based time series forecasting
+Read the full text of arXiv:2401.12345 and summarize the Methods section
 ```
 ```
-Give me a literature survey on protein folding prediction methods since 2020
+Add citations to this Introduction paragraph: <paste text>
 ```
 ```
-Search the full text of papers for "dropout rate 0.1 Transformer implementation"
+Give me a literature survey on protein folding methods since 2020
 ```
+For detailed usage examples, see [docs/tutorial.md](docs/tutorial.md).
 ## Project Structure
 ```
 ai4scholar/
-├── src/                    # TypeScript source
-│   ├── tools/              # 17 tool implementations
-│   │   ├── api-client.ts   # HTTP client for ai4scholar.net
-│   │   ├── semantic-scholar.ts  # 9 Semantic Scholar tools
-│   │   ├── pubmed.ts       # 4 PubMed tools
+├── src/
+│   ├── tools/
+│   │   ├── api-client.ts        # HTTP client for ai4scholar.net
+│   │   ├── semantic-scholar.ts  # 17 Semantic Scholar tools
+│   │   ├── pubmed.ts            # 5 PubMed tools
 │   │   ├── google-scholar.ts    # Google Scholar search
-│   │   ├── arxiv.ts        # arXiv search
-│   │   ├── biorxiv.ts      # bioRxiv + medRxiv search
-│   │   ├── result.ts       # Tool result helpers
-│   │   └── params.ts       # Parameter parsing
-│   ├── hooks/              # Agent hooks
-│   └── commands.ts         # Slash commands
-├── scripts/                # Python helper scripts
-│   ├── fulltext_search.py  # Fulltext search + data processing
-│   ├── generate_html.py    # HTML report generator
-│   └── translate_titles.py # Title translation helper
-├── assets/                 # Report templates
-│   ├── template_fulltext.html
-│   └── styles.css
-├── skills/                 # Agent skills
-│   └── literature-survey/
+│   │   ├── arxiv.ts             # 3 arXiv tools
+│   │   ├── biorxiv.ts           # 6 bioRxiv/medRxiv tools
+│   │   ├── doi-download.ts      # 2 DOI-based download tools
+│   │   ├── quality-rank.ts      # Paper quality ranking (CCF)
+│   │   ├── pdf-utils.ts         # PDF download & text extraction
+│   │   ├── result.ts            # Tool result helpers
+│   │   └── params.ts            # Parameter parsing
+│   ├── hooks/
+│   │   ├── scholar-mode.ts      # Scholar mode system prompt
+│   │   └── inject-skill.ts      # Skill injection for sub-agents
+│   └── commands.ts              # Slash commands
+├── scripts/                     # Python helpers (HTML reports)
+├── assets/                      # Report templates
+├── skills/
+│   ├── literature-survey/
+│   │   └── SKILL.md
+│   └── auto-cite/
 │       └── SKILL.md
-├── openclaw.plugin.json    # Plugin manifest
-└── index.ts                # Plugin entry point
+├── data/
+│   └── ccf_2022.jsonl           # CCF ranking data
+├── docs/
+│   └── tutorial.md              # Installation & usage tutorial
+├── openclaw.plugin.json
+└── index.ts
 ```
 ## License

package/dist/src/tools/quality-rank.d.ts CHANGED Viewed

@@ -21,7 +21,7 @@ interface PaperInput {
 export declare function createPaperQualityRankTool(): {
     name: string;
     description: string;
-    inputSchema: import("@sinclair/typebox").TObject<{
+    parameters: import("@sinclair/typebox").TObject<{
         papers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
             title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
             year: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;

package/dist/src/tools/quality-rank.js CHANGED Viewed

@@ -86,7 +86,7 @@ export function createPaperQualityRankTool() {
     return {
         name: "paper_quality_rank",
         description: "Evaluate and rank academic papers by quality. Uses CCF ranking (A/B/C), citation count, publication year, and author h-index to compute a composite quality score. Input a JSON array of paper objects (from search results). Returns papers sorted by quality score with CCF classification.",
-        inputSchema: Type.Object({
+        parameters: Type.Object({
             papers: Type.Array(Type.Object({
                 title: Type.Optional(Type.String()),
                 year: Type.Optional(Type.Number()),

package/dist/src/tools/quality-rank.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"quality-rank.js","sourceRoot":"","sources":["../../../src/tools/quality-rank.ts"],"names":[],"mappings":"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~~WAAW~~,EAAE,IAAI,CAAC,MAAM,CAAC;~~YACvB~~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"}
1	+ {"version":3,"file":"quality-rank.js","sourceRoot":"","sources":["../../../src/tools/quality-rank.ts"],"names":[],"mappings":"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"}

package/docs/tutorial.md ADDED Viewed

@@ -0,0 +1,329 @@
+# AI4Scholar OpenClaw 插件：安装、配置与使用教程
+> 让你的 OpenClaw 龙虾学会搜论文、读全文、评质量、加引用。
+---
+## 一、前提条件
+在安装 AI4Scholar 插件之前，请确保以下环境已就绪：
+- **OpenClaw** 已安装并可正常运行（版本 ≥ 2024.0.0）
+- **Node.js** ≥ 18
+- **ai4scholar.net 账号**（用于获取 API Key）
+如果你还需要生成 HTML 格式的文献综述报告（可选），额外需要：
+- **Python** ≥ 3.8
+---
+## 二、获取 API Key
+1. 打开 [ai4scholar.net](https://ai4scholar.net)
+2. 注册或登录你的账号
+3. 进入 [API Keys 页面](https://ai4scholar.net/dashboard?view=api-keys)
+4. 点击「创建 API Key」，复制生成的 Key
+请妥善保管你的 API Key，不要分享给他人。
+---
+## 三、安装插件
+在终端中执行：
+```bash
+openclaw plugins install ai4scholar
+```
+安装完成后，重启 OpenClaw Gateway：
+```bash
+openclaw gateway
+```
+### 从源码安装（可选）
+如果你想参与开发或查看源码：
+```bash
+git clone https://github.com/literaf/ai4scholar.git
+cd ai4scholar
+pnpm install
+pnpm build
+openclaw plugins install -l .
+```
+---
+## 四、配置插件
+安装完成后，需要在 `openclaw.json` 中配置 API Key。
+打开你的 `openclaw.json` 文件，在 `plugins.entries` 下添加或修改 `ai4scholar` 配置：
+```json
+{
+  "plugins": {
+    "entries": {
+      "ai4scholar": {
+        "enabled": true,
+        "config": {
+          "apiKey": "你的API Key"
+        }
+      }
+    }
+  }
+}
+```
+也可以通过环境变量设置：
+```bash
+export AI4SCHOLAR_API_KEY="你的API Key"
+```
+配置完成后重启 Gateway 即可生效。
+---
+## 五、插件能力一览
+安装后，你的 OpenClaw Agent 将获得 **35 个学术工具**，覆盖 6 大数据库平台。
+### 5.1 论文搜索
+| 工具 | 平台 | 说明 |
+|------|------|------|
+| `search_semantic` | Semantic Scholar | 语义搜索，支持年份过滤 |
+| `search_pubmed` | PubMed | 生物医学论文搜索，支持日期范围 |
+| `search_google_scholar` | Google Scholar | 通过 ai4scholar 代理搜索 |
+| `search_arxiv` | arXiv | 搜索预印本论文 |
+| `search_biorxiv` | bioRxiv | 搜索生物学预印本 |
+| `search_medrxiv` | medRxiv | 搜索医学预印本 |
+| `search_semantic_snippets` | Semantic Scholar | 在论文全文中搜索文本片段 |
+| `search_semantic_bulk` | Semantic Scholar | 批量搜索，单次最多 1000 条 |
+| `search_semantic_paper_match` | Semantic Scholar | 按标题精确匹配 |
+### 5.2 论文详情
+| 工具 | 说明 |
+|------|------|
+| `get_semantic_paper_detail` | 获取论文详细信息（支持 DOI、arXiv ID、PMID 等） |
+| `get_pubmed_paper_detail` | 获取 PubMed 论文详情 |
+| `get_semantic_paper_batch` | 批量获取论文详情（最多 500 篇） |
+| `get_pubmed_paper_batch` | 批量获取 PubMed 论文详情 |
+### 5.3 引用与参考文献
+| 工具 | 说明 |
+|------|------|
+| `get_semantic_citations` | 查看谁引用了这篇论文 |
+| `get_semantic_references` | 查看这篇论文引用了谁 |
+| `get_pubmed_citations` | PubMed 引用查询 |
+| `get_pubmed_related` | PubMed 相关论文推荐 |
+### 5.4 作者信息
+| 工具 | 说明 |
+|------|------|
+| `search_semantic_authors` | 按姓名搜索作者 |
+| `get_semantic_author_detail` | 获取作者详情（h-index、论文数等） |
+| `get_semantic_author_papers` | 获取某作者的所有论文 |
+| `get_semantic_author_batch` | 批量获取作者详情（最多 1000 人） |
+| `get_semantic_paper_authors` | 获取某论文的所有作者详情 |
+### 5.5 论文推荐
+| 工具 | 说明 |
+|------|------|
+| `get_semantic_recommendations` | 基于多篇论文推荐相关论文 |
+| `get_semantic_recommendations_for_paper` | 基于单篇论文推荐 |
+### 5.6 PDF 下载与全文阅读
+| 工具 | 说明 |
+|------|------|
+| `download_semantic` | 获取 Semantic Scholar 开放获取 PDF 链接 |
+| `read_semantic_paper` | 下载并提取 Semantic Scholar 论文全文 |
+| `download_arxiv` | 获取 arXiv 论文 PDF 链接 |
+| `read_arxiv_paper` | 下载并提取 arXiv 论文全文 |
+| `download_biorxiv` | 获取 bioRxiv 论文 PDF 链接 |
+| `download_medrxiv` | 获取 medRxiv 论文 PDF 链接 |
+| `read_biorxiv_paper` | 下载并提取 bioRxiv 论文全文 |
+| `read_medrxiv_paper` | 下载并提取 medRxiv 论文全文 |
+| `download_by_doi` | 通过 DOI 下载论文 PDF（支持校园网机构访问） |
+| `read_by_doi` | 通过 DOI 下载并提取论文全文 |
+### 5.7 论文质量评估
+| 工具 | 说明 |
+|------|------|
+| `paper_quality_rank` | 基于 CCF 分级、引用量、发表年份、作者 h-index 综合评分排序 |
+---
+## 六、Slash 命令
+安装插件后，你可以在聊天中使用以下快捷命令：
+| 命令 | 说明 |
+|------|------|
+| `/library` | 列出当前项目中已下载的论文 |
+| `/projects` | 列出所有文献项目 |
+| `/reading-list` | 显示当前项目的阅读列表 |
+---
+## 七、内置技能
+插件包含两个 AI 技能，Agent 会根据你的需求自动调用。
+### 7.1 文献综述（literature-survey）
+**触发方式**：当你明确要求 Agent 做一份完整的文献综述或生成 HTML 报告时。
+**示例**：
+```
+帮我做一份关于"大语言模型在药物发现中的应用"的文献综述，
+覆盖过去三年的核心进展，至少搜索 Semantic Scholar 和 PubMed。
+```
+Agent 会自动执行多轮搜索、筛选、整理，生成结构化的综述报告。
+### 7.2 自动引用标注（auto-cite）
+**触发方式**：当你粘贴一段学术文本，并要求 Agent 添加引用/参考文献时。
+**示例**：
+```
+请给下面这段文字加上引用：
+Large language models have shown remarkable capabilities in understanding
+and generating scientific text. Recent studies demonstrate that these models
+can assist in hypothesis generation, experimental design, and data analysis.
+The integration of tool-use capabilities further enhances their potential
+for automated scientific discovery.
+```
+Agent 会自动：
+1. 分析文本，识别需要引用的断言
+2. 在 Semantic Scholar、PubMed 等平台搜索匹配论文
+3. 用 `paper_quality_rank` 评估候选论文质量
+4. 在原文中插入引用标记 [1]、[2, 3]
+5. 在末尾生成 APA 格式参考文献列表
+所有引用的论文都是从真实数据库搜索得到的，DOI 可验证。
+---
+## 八、使用示例
+以下是一些常见的使用场景，直接在聊天中发送即可。
+### 搜索论文
+```
+帮我搜一下 CRISPR 在肿瘤免疫治疗中的最新进展
+```
+```
+搜一下 2023 年以来关于 diffusion model 在蛋白质设计中的应用
+```
+### 查看论文详情
+```
+帮我查一下这篇论文的详细信息：10.1038/s41586-021-03819-2
+```
+### 查看引用网络
+```
+这篇 AlphaFold 论文被哪些高引论文引用了？
+```
+### 阅读全文
+```
+帮我读一下 arXiv:2401.12345 这篇论文的全文，总结一下 Methods 部分
+```
+### 评估论文质量
+```
+帮我评估一下刚才搜到的这些论文的质量，按 CCF 分级排个序
+```
+### 通过 DOI 下载论文
+```
+帮我下载这篇论文的 PDF：10.1126/science.abj8754
+```
+> 注意：通过 DOI 下载付费论文需要你的 OpenClaw 服务器部署在有机构访问权限的网络（如校园网）中。
+### 自动加引用
+```
+给下面这段 Introduction 加上引用：
+（粘贴你的学术文本）
+```
+### 文献综述
+```
+请帮我做一份关于"AI Agent 在科学研究中的应用"的文献综述，
+搜索 Semantic Scholar、PubMed 和 arXiv，覆盖 2022-2025 年。
+```
+---
+## 九、常见问题
+### Q: 安装后提示 "plugin not found"
+确保 `openclaw.json` 中的 `plugins.entries` 里有 `ai4scholar` 的配置项。如果刚安装完就报错，尝试运行：
+```bash
+openclaw doctor --fix
+```
+### Q: 搜索结果为空
+检查以下几点：
+1. API Key 是否正确配置
+2. 网络是否通畅（需要能访问 ai4scholar.net）
+3. 搜索关键词是否过于狭窄，尝试换更宽泛的关键词
+### Q: DOI 下载论文失败
+通过 DOI 下载付费论文需要网络环境支持。如果你的 OpenClaw 服务器不在校园网或有机构订阅的网络中，只能下载开放获取（Open Access）的论文。
+对于开放获取论文，推荐优先使用 `download_semantic`、`download_arxiv` 等工具。
+### Q: PDF 全文提取的文本质量不好
+PDF 文本提取依赖论文的 PDF 格式。扫描版 PDF 或图片较多的论文可能提取效果不佳。对于这类论文，建议直接阅读 PDF 原文。
+### Q: 如何更新插件
+```bash
+openclaw plugins install ai4scholar
+```
+重新执行安装命令会自动更新到最新版本。更新后需要重启 Gateway。
+---
+## 十、反馈与贡献
+- **GitHub**: [github.com/literaf/ai4scholar](https://github.com/literaf/ai4scholar)
+- **网站**: [ai4scholar.net](https://ai4scholar.net)
+- **问题反馈**: 请在 [GitHub Issues](https://github.com/literaf/ai4scholar/issues) 中提交
+欢迎提交 PR 和 Issue，一起让每只龙虾都学会搜论文。

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "ai4scholar",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Multi-source academic literature search, management, and analysis plugin for OpenClaw. Powered by ai4scholar.net.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
     "scripts",
     "data",
     "assets",
+    "docs",
     "openclaw.plugin.json"
   ],
   "keywords": [