poe1 item search_for poe.ninja API

Path of Exile 市场价格查询工具。通过 poe.ninja API 获取游戏物品实时价格数据。适用场景：(1) 查询通货汇率（Chaos/Divine/Mirror 等）(2) 查询装备、技能宝石、地图等物品价格 (3) 查询预言卡、圣甲虫、精髓等消耗品价格 (4) 获取价格趋势数据 (5) 跨联盟价...

Security Scan

The skill is internally consistent: it is a poe.ninja API client that only performs public HTTP queries to poe.ninja and does not request secrets, special binaries, or unexpected system access.

Purpose & Capability

The name/description say it queries poe.ninja for Path of Exile prices and the included scripts and docs only implement that behavior (GET requests to poe.ninja endpoints). There are no unrelated requirements (no cloud creds, no extra services).

Instruction Scope

SKILL.md and the scripts only instruct the agent to call poe.ninja endpoints and to run the provided Python scripts; they do not read arbitrary files, environment variables, or send data to other endpoints.

Install Mechanism

There is no install spec (instruction-only skill) and the bundle contains small Python scripts. Nothing is downloaded from untrusted URLs or extracted during install.

Credentials

The skill declares no required environment variables or credentials and the code does not access secrets or configuration outside its scope (it builds public API URLs only).

Persistence & Privilege

always is false and the skill does not request or modify other skills or system settings. It can be invoked autonomously (default), which is normal for skills and not a red flag here.

Assessment

This skill appears to do exactly what it claims: query the public poe.ninja API and display results. Before installing, consider: (1) it makes outbound HTTP requests to https://poe.ninja (no credentials needed), so it requires network access; (2) avoid issuing rapid automated queries to respect rate limits (the repo and docs already warn about this); (3) if you want extra caution, inspect the included Python scripts yourself (they are short and readable) or run them in an isolated environment. If you prefer the agent not call external services autonomously, disable autonomous invocation for this skill in your agent settings.

Poe Ninja API

查询 Path of Exile 游戏内物品实时市场价格，通过 poe.ninja API 获取数据。

快速开始

基础 API 端点

所有 API 端点基于 https://poe.ninja/api/data/

两种数据类型：

• currencyoverview - 通货类（Currency、Fragment）
• itemoverview - 物品类（其余所有类型）

必需参数：

• league - 联盟名称（如 Settlers、Standard、Hardcore）
• type - 物品类型

物品类型列表

通货类（currencyoverview）

类型	说明
Currency	通货（Chaos、Divine、Mirror 等）
Fragment	碎片（Sacrifice at Dusk 等）

物品类（itemoverview）

类型	说明
Oil	油（Golden Oil 等）
Incubator	孵化器
Scarab	圣甲虫
Fossil	化石
Resonator	共振器
Essence	精髓
DivinationCard	预言卡
SkillGem	技能宝石
BaseType	基底类型
HelmetEnchant	头盔附魔
UniqueMap	传奇地图
Map	地图
UniqueJewel	传奇珠宝
UniqueFlask	传奇药水
UniqueWeapon	传奇武器
UniqueArmour	传奇护甲
UniqueAccessory	传奇饰品
Beast	野兽
Vial	小瓶
DeliriumOrb	谵妄球
Omen	征兆
UniqueRelic	传奇遗物
ClusterJewel	集群珠宝
BlightedMap	凋零地图
BlightRavagedMap	凋零掠夺地图
Invitation	邀请函
Memory	记忆
Coffin	棺材
AllflameEmber	全燃余烬

API 调用示例

查询通货价格

GET https://poe.ninja/api/data/currencyoverview?league=Settlers&type=Currency

查询传奇武器价格

GET https://poe.ninja/api/data/itemoverview?league=Settlers&type=UniqueWeapon

查询预言卡价格

GET https://poe.ninja/api/data/itemoverview?league=Settlers&type=DivinationCard

响应数据结构

Currency 响应

{
  "lines": [
    {
      "currencyTypeName": "Mirror of Kalandra",
      "chaosEquivalent": 143915.04,
      "pay": { "value": 0.0000070301 },
      "receive": { "value": 146900 },
      "paySparkLine": { "totalChange": 42.25 },
      "receiveSparkLine": { "totalChange": -3.92 },
      "detailsId": "mirror-of-kalandra"
    }
  ],
  "currencyDetails": [
    {
      "id": 22,
      "name": "Mirror of Kalandra",
      "tradeId": "mirror",
      "icon": "https://..."
    }
  ]
}

关键字段：

• chaosEquivalent - Chaos 等值价格
• pay.value - 购买时需要的货币数量
• receive.value - 出售时获得的货币数量
• totalChange - 价格变化百分比

Item 响应

{
  "lines": [
    {
      "id": 22607,
      "name": "Golden Oil",
      "baseType": "Golden Oil",
      "chaosValue": 59,
      "exaltedValue": 2.42,
      "divineValue": 0.23,
      "sparkline": { "totalChange": -1.67 },
      "detailsId": "golden-oil",
      "listingCount": 1997
    }
  ]
}

关键字段：

• chaosValue - Chaos 价格
• exaltedValue - Exalted 价格
• divineValue - Divine 价格
• sparkline.totalChange - 价格变化趋势
• listingCount - 在售数量

使用脚本

脚本列表

脚本	说明
get_currency.py	获取通货价格
get_item.py	获取物品价格
search_item.py	搜索特定物品

常用查询

查询 Divine Orb 价格

使用 get_currency.py 查询：

python scripts/get_currency.py --league Settlers --search "divine"

查询特定传奇装备

使用 get_item.py 查询：

python scripts/get_item.py --league Settlers --type UniqueWeapon --search "Starforge"

获取价格趋势

响应中的 sparkline 字段包含价格趋势数据，totalChange 表示变化百分比。

注意事项

1. 联盟名称 - 每个新赛季联盟名称不同，需要使用当前联盟名称
2. 价格更新 - poe.ninja 数据每小时更新一次
3. 低置信度数据 - lowConfidenceSparkline 表示交易量低，价格可能不准确
4. 图标链接 - 响应中的 icon 字段提供物品图标 URL

资源文件

references/

• api_reference.md - 完整 API 文档和响应示例

scripts/

• get_currency.py - 查询通货价格
• get_item.py - 查询物品价格
• search_item.py - 搜索物品