OMDB 电影和电视检索
这个包通过Open Movie Database API为电影,电视剧,以及各集提供代理标题搜索和细节查询. 详细结果包括出演,剧组,情节,收视率,以及票房数据.
安装
npm install @framers/agentos-ext-omdb
同伴依赖 : @framers/agentos 有范围 >=0.10.40。 。 。 .
使用量
import { AgentOS } from '@framers/agentos';
const agentos = await AgentOS.create({
extensionManifest: {
packs: [
{
package: '@framers/agentos-ext-omdb',
options: { omdbApiKey: process.env.OMDB_API_KEY },
},
],
},
});
配置
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
|---|---|---|---|---|
omdbApiKey | omdb.apiKey | OMDB_API_KEY | 对 | 空字符串 |
priority | 无 | 无 | 没有 | 50 |
密钥解析自 omdbApiKey,则 getSecret('omdb.apiKey'),则 OMDB_API_KEY。工具描述符声明 omdb.apiKey 作为必要的秘密。 从 OMDB 的 API 密钥页面。 。 。 .
工具
| 工具 | 它会做什么 |
|---|---|
omdb_search | 以 IMDB 代号搜索电影,电视剧,以及按标题和返回元数据进行剧集. |
omdb_details | 获得电影,电视剧,或由IMDB id或标题提供剧集细节. |
omdb_search
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
query | string | 对 | 电影、电视节目或剧集的标题搜索字符串. |
year | integer | 没有 | 可选发布年以收缩结果. |
type | string, enum: (中文(简体) ) movie, (中文(简体) ), series, (中文(简体) ), episode | 没有 | 可选媒体类型过滤器. |
page | integer | 没有 | 标出结果的页码(每页10个结果). |
这个 page schema 有最小值和默认值 1。 。 。 .
omdb_details
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
imdbId | string | 没有 | IMDB标识符(如"tt1375666"). 优先于头衔. |
title | string | 没有 | 标题往上看。 使用时 imdbId 未提供. |
year | integer | 没有 | 可选发布年拆分标题. |
plot | string, enum: (中文(简体) ) short, (中文(简体) ), full | 没有 | 情节摘要的长度. |
这个 plot 计划默认为 short。执行要求 imdbId 或者说 title。 。 。 .
页:1
请求使用 http://www.omdbapi.com/ 使用查询字符串中的 API 键。 工厂接受缺失的密钥,并将空弦传递给服务. HTTP故障和API出错反应成为工具出错,包括无结果的搜索.
搜索返回 results 财务报告和审定财务报表 totalResults。细节将缺失的元数据规范化为空字符串或 N/A 并缺少对空数组的收视率。 两种工具都没有写副作用并声明 capability:media_search。 。 。 .
许可证
阿帕奇 - 2.0