Openalex 工具

Configuration File: openalex_tools.json Tool Type: Local Tools Count: 8

此页面包含 openalex_tools.json 配置文件中定义的所有工具。

可用工具

openalex_get_author (Type: OpenAlexRESTTool)

Get a single OpenAlex author by Author ID (A…). You can pass either the short ID (e.g., “A50012…

openalex_get_author tool specification

工具信息：

• Name: openalex_get_author

• Type: OpenAlexRESTTool

• Description: Get a single OpenAlex author by Author ID (A…). You can pass either the short ID (e.g., “A5001226970”) or the full URL (e.g., “https://openalex.org/A5001226970”).

参数：

• author_id (string) (required) OpenAlex Author ID (A…) or full OpenAlex URL.

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_get_author",
    "arguments": {
        "author_id": "example_value"
    }
}
result = tu.run(query)

openalex_get_institution (Type: OpenAlexRESTTool)

Get a single OpenAlex institution by Institution ID (I…). You can pass either the short ID (e.g…

openalex_get_institution tool specification

工具信息：

• Name: openalex_get_institution

• Type: OpenAlexRESTTool

• Description: Get a single OpenAlex institution by Institution ID (I…). You can pass either the short ID (e.g., “I136199984”) or the full URL (e.g., “https://openalex.org/I136199984”).

参数：

• institution_id (string) (required) OpenAlex Institution ID (I…) or full OpenAlex URL.

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_get_institution",
    "arguments": {
        "institution_id": "example_value"
    }
}
result = tu.run(query)

openalex_get_work (Type: OpenAlexRESTTool)

Get a single OpenAlex work (paper) by OpenAlex Work ID (W…). You can pass either the short ID (…

openalex_get_work tool specification

工具信息：

• Name: openalex_get_work

• Type: OpenAlexRESTTool

• Description: Get a single OpenAlex work (paper) by OpenAlex Work ID (W…). You can pass either the short ID (e.g., “W2626778328”) or the full URL (e.g., “https://openalex.org/W2626778328”).

参数：

• openalex_id (string) (required) OpenAlex Work ID (W…) or full OpenAlex URL.

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_get_work",
    "arguments": {
        "openalex_id": "example_value"
    }
}
result = tu.run(query)

openalex_get_work_by_doi (Type: OpenAlexRESTTool)

Get a single OpenAlex work (paper) by DOI. Provide a DOI string like “10.65215/2q58a426” (you can…

openalex_get_work_by_doi tool specification

工具信息：

• Name: openalex_get_work_by_doi

• Type: OpenAlexRESTTool

• Description: Get a single OpenAlex work (paper) by DOI. Provide a DOI string like “10.65215/2q58a426” (you can also pass a DOI URL like “https://doi.org/10.65215/2q58a426”).

参数：

• doi (string) (required) DOI identifier (preferred) or DOI URL.

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_get_work_by_doi",
    "arguments": {
        "doi": "example_value"
    }
}
result = tu.run(query)

**openalex_literature_search**（类型：OpenAlex工具）

Search for academic literature using OpenAlex. Supports optional full-text-index filtering (has_f…

openalex_literature_search 工具规格说明

工具信息：

• 名称：openalex_literature_search

• 类型：OpenAlexTool

• Description: Search for academic literature using OpenAlex. Supports optional full-text-index filtering (has_fulltext + fulltext.search) when you need body-only term discovery, but note: OpenAlex full-text indexing is incomplete, and a work can be open-access elsewhere (e.g., PMC) while still having has_fulltext=false in OpenAlex. Returns paper metadata and (when available) OA links/content URLs.

参数：

• search_keywords (string) (optional) Keywords to search for in paper titles/abstracts/etc. For full-text-index-only matching, also use require_has_fulltext/fulltext_terms.

• query (string) (optional) Alias for search_keywords (recommended when you standardize on query across multiple paper-search tools).

• ``max_results``（整数）（可选）要检索的论文最大数量（默认值：10，最大值：200）。

• limit (integer) (optional) Alias for max_results (OpenAlex max 200).

• ``year_from``（整数）（可选）用于筛选出版日期的起始年份（例如：2020）。这是一个可选参数，用于将搜索范围限制为从该年份起发布的论文。

• ``year_to``（整数）（可选）用于筛选出版日期的结束年份（例如：2023）。可选参数，用于将搜索范围限制为截至该年份发表的论文。

• ``open_access``（布尔值）（可选）仅筛选开放获取的论文。设置为 true 表示仅开放获取的论文，设置为 false 表示非开放获取的论文，或省略以包含所有论文。

• require_has_fulltext (boolean) (optional) If true, filters to works where OpenAlex indicates a full-text index is available (has_fulltext:true).

• fulltext_terms (array) (optional) Optional list of terms that must occur in OpenAlex full-text index (adds fulltext.search:<term> filters and implicitly enables require_has_fulltext).

示例用法：

query = {
    "name": "openalex_literature_search",
    "arguments": {
    }
}
result = tu.run(query)

openalex_search_authors (Type: OpenAlexRESTTool)

Search OpenAlex authors via the /authors endpoint. Use this to discover Author IDs (A…) and the…

openalex_search_authors tool specification

工具信息：

• Name: openalex_search_authors

• Type: OpenAlexRESTTool

• Description: Search OpenAlex authors via the /authors endpoint. Use this to discover Author IDs (A…) and then fetch details with openalex_get_author.

参数：

• search (string) (required) Author name search query. Example: “Yann LeCun”.

• per_page (integer) (optional) Results per page (OpenAlex max 200).

• page (integer) (optional) Page number (1-indexed).

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_search_authors",
    "arguments": {
        "search": "example_value"
    }
}
result = tu.run(query)

openalex_search_institutions (Type: OpenAlexRESTTool)

Search OpenAlex institutions via the /institutions endpoint. Use this to discover Institution IDs…

openalex_search_institutions tool specification

工具信息：

• Name: openalex_search_institutions

• Type: OpenAlexRESTTool

• Description: Search OpenAlex institutions via the /institutions endpoint. Use this to discover Institution IDs (I…) and then fetch details with openalex_get_institution.

参数：

• search (string) (required) Institution name search query. Example: “Harvard University”.

• per_page (integer) (optional) Results per page (OpenAlex max 200).

• page (integer) (optional) Page number (1-indexed).

• mailto (string) (optional) Optional contact email for OpenAlex polite pool.

示例用法：

query = {
    "name": "openalex_search_institutions",
    "arguments": {
        "search": "example_value"
    }
}
result = tu.run(query)

openalex_search_works (Type: OpenAlexRESTTool)

Search OpenAlex works (papers) via the /works endpoint. Supports both general search and optional…

openalex_search_works tool specification

工具信息：

• Name: openalex_search_works

• Type: OpenAlexRESTTool

• Description: Search OpenAlex works (papers) via the /works endpoint. Supports both general search and optional full-text-index filtering: set require_has_fulltext=true and/or pass fulltext_terms to add OpenAlex filters (has_fulltext:true and fulltext.search:<term>). Important: has_fulltext/fulltext.search only match works where OpenAlex has indexed full text; this can miss papers whose full text is available elsewhere (e.g., PMC) but not indexed by OpenAlex. Use this to discover Work IDs (W…) and DOIs, then follow up with openalex_get_work/openalex_get_work_by_doi to retrieve OA links and (sometimes) content_urls.

参数：

• search (string) (optional) Search query for works. Use filter + fulltext_terms/require_has_fulltext when you need full-text-index-only matching.

• query (string) (optional) Alias for search (recommended when you standardize on query across multiple paper-search tools).

• filter (string) (optional) OpenAlex filter string (comma-separated). Example: “from_publication_date:2020-01-01,is_oa:true”.

• require_has_fulltext (boolean) (optional) If true, appends OpenAlex filter has_fulltext:true (keeps only works with full-text index available).

• fulltext_terms (array) (optional) Optional list of terms to match in OpenAlex full-text index. Adds one or more fulltext.search:<term> filters and implicitly enables require_has_fulltext.

• per_page (integer) (optional) Results per page (OpenAlex max 200).

• limit (integer) (optional) Alias for per_page (OpenAlex max 200).

• page (integer) (optional) Page number (1-indexed).

• sort (string) (optional) Sort order string, e.g. “cited_by_count:desc”.

• mailto (string) (optional) Optional contact email for OpenAlex polite pool. If omitted, ToolUniverse uses a default.

示例用法：

query = {
    "name": "openalex_search_works",
    "arguments": {
    }
}
result = tu.run(query)

导航

• 可用工具 - 返回工具概览

• 工具加载教程 - 加载本地工具