说明感兴趣的志愿主题，以及希望现场、远程还是混合参与，让助手准备支持的条件，查看实际机会、主办机构和地域要求。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Idealist
说明感兴趣的志愿主题，以及希望现场、远程还是混合参与，让助手准备支持的条件，查看实际机会、主办机构和地域要求。
取得一页 Idealist 志愿服务机会摘要，包括岗位标题、组织名称、简介、议题标签及来源页面。结合参与方式、可用的远程地域范围，以及来源报告的页码和匹配数量阅读。
请在 Idealist 查找与[关注议题或岗位关键词]有关、参与方式为[参与方式，例如远程]的志愿机会。先看第一页，展示各岗位的主办机构、简介、议题标签、地域条件和来源页面。
搜索摘要不能证明机会当前仍开放、个人符合条件或已列出全部机会。参与前查看所选条目的完整条件；远程标签可能附带地域限制，来源统计也可能不是穷尽数量。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
志愿机会搜索选项queryParams | object | 选填 | 可选的关键词、议题代码、地点条件和页码；可明确提供需要的筛选条件与页码。 |
搜索关键词queryParams.q | string | 选填 | 描述所需岗位或主题的关键词。 |
结果页码queryParams.page | integer | 选填 | 可选页码，从 0 开始；来源文档说明最多提供 50 页搜索结果。 |
搜索半径（米）queryParams.radius | integer | 选填 | 以米为单位，围绕所提供坐标进行搜索的半径。 |
搜索中心queryParams.location | string | 选填 | 用逗号分隔的纬度与经度，例如 40.7128,-74.0060；请提供目标搜索区域的坐标。 |
议题领域代码queryParams.cause_areas | string | 选填 | 用逗号分隔的来源代码，例如 EDUCATION（教育）、ENVIRONMENT（环境）或 ANIMALS（动物）；使用当前输入要求列明的代码。 |
参与地点类型queryParams.location_type | string | 选填 | ONSITE 表示现场，REMOTE 表示远程，HYBRID 表示现场与远程结合；仍需查看各条结果的地域条件。 |
{
"type": "object",
"required": [],
"properties": {
"queryParams": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "关键词。"
},
"page": {
"type": "integer",
"description": "分页页码，从 0 开始。"
},
"radius": {
"type": "integer",
"description": "以 location 为中心的搜索半径，单位为米。"
},
"location": {
"type": "string",
"description": "地理搜索的纬度和经度，例如 40.7128,-74.0060。"
},
"cause_areas": {
"type": "string",
"description": "用逗号分隔的服务领域筛选，可选 EDUCATION、HEALTH_MEDICINE、ENVIRONMENT、CHILDREN_YOUTH、ARTS_MUSIC、COMMUNITY_DEVELOPMENT、ANIMALS、HOUSING_HOMELESSNESS、HUMAN_RIGHTS_CIVIL_LIBERTIES、CLIMATE_CHANGE、VOLUNTEERING、SCIENCE_TECHNOLOGY。"
},
"location_type": {
"type": "string",
"description": "地点类型筛选：ONSITE、REMOTE 或 HYBRID。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}此工具未提供固定的返回结构。字段类型根据已保存的结果样本整理，实际返回可能有所不同。
| 字段 / 路径 | 类型 | 含义 |
|---|---|---|
志愿机会摘要列表result.data.hits | array | 本次响应页面中的条目。来源文档说明每页 20 条，实际响应可能更少；这些摘要用于选择需要进一步了解的机会。 |
机会标题result.data.hits[].name | string | 来源所列志愿机会的标题。 |
主办组织名称result.data.hits[].orgName | string | 条目所列组织名称；目录中的名称不能独立证明组织的法律身份。 |
机会标识result.data.hits[].objectID | string | 所选机会的 Idealist 记录标识，可用于另行查询该机会的详情记录。 |
英文来源页面result.data.hits[].url.en | string | 此条目提供的英文 Idealist 页面引用。 |
条目简介result.data.hits[].description | string | 来源对岗位及背景的介绍，可能包含参与条件；进一步说明应结合所选机会的详情或来源页面阅读。 |
返回的议题标签result.data.hits[].areasOfFocus | array | 该机会的来源议题标签列表；核对是否符合兴趣时，保留返回的标签。 |
条目参与方式result.data.hits[].locationType | string | 来源分类，如 ONSITE（现场）、REMOTE（远程）或 HYBRID（混合）；远程分类并不取消地域或其他参与条件。 |
条目城市result.data.hits[].city | string | null | 条目关联的城市，应结合参与方式和远程地域范围阅读。 |
条目国家result.data.hits[].country | string | null | 条目关联的国家，与远程参与范围分开阅读。 |
远程地域范围result.data.hits[].remoteZone | string | null | 来源提供时的范围标签：CITY（城市）、STATE（州或地区）、COUNTRY（国家）或 WORLD（全球）。null 表示此字段未说明范围，不能据此认定可全球参与。 |
远程国家条件result.data.hits[].remoteCountry | string | null | 来源提供的远程参与国家代码；保留 null，不自行补入国家。 |
远程州或地区条件result.data.hits[].remoteState | string | null | 来源提供时的远程参与州或地区代码。 |
返回页码result.data.page | number | 来源返回的页码，从 0 开始。 |
来源报告的匹配数量result.data.nbHits | number | 来源报告的搜索匹配数量。结合 exhaustive.nbHits 阅读；非穷尽统计不能当作所有机会的精确清单。 |
数量是否穷尽的标记result.data.exhaustive.nbHits | boolean | 来源布尔值，说明所报告匹配数量是否为穷尽统计；false 时不应将该数量表述为穷尽总量。 |
查找附近志愿机会时，提供目标区域的经纬度，以及以米为单位的半径。查找远程志愿机会时，可请求 REMOTE，并查看各条目的国家、州或地区及城市条件；工具不会自动定位你。
可结合简介和议题标签选择感兴趣的机会，再保留所选 objectID，另行查询机会详情。投入时间、申请步骤及参与要求需要结合具体记录了解；搜索页面并非完整的参与约定。
需要另一页时明确请求；执行前查看当前选项：当前 Tool 输入要求
助手准备支持的选项并管理翻页。想查找附近机会时，提供[城市或地点]和[希望查找的距离]，由助手先确认可用位置。远程机会也要核对地域条件。
请在 Idealist 查找与[关注议题或岗位关键词]有关、参与方式为[参与方式，例如远程]的志愿机会。先看第一页，展示各岗位的主办机构、简介、议题标签、地域条件和来源页面。
比较实际简介、主办机构和议题标签。想看完整详情时，按返回的名称和主办机构选择机会，助手会使用该条实际记录。
来源未说明多个议题必须全部符合，还是只需符合其中一项。助手应结合实际返回的议题标签核对你的要求，不假设每项所选议题都已符合。