Coze官方插件不够用？手把手教你自己造（白嫖）

在《‍♂️Coze国内版插件汇总-By油猴》中我们提到了这几点：

插件和工作流节点的本质→API接口调用的封装。

插件工具是插件的子集，插件指定【BaseURL+默认请求头】，插件工具指定【调用接口、输入/输出参数】，调用同一插件下的不同插件工具，本质上就是调用同一域名下的不同接口。

Coze国内版提供了如下68个官方插件工具：

插件工具名

所属插件

作用

bingWebSearch

必应搜索

必应搜索引擎。当你需要搜索你不知道的信息，比如天气、汇率、时事等，这个工具非常有用。但是绝对不要在用户想要翻译的时候使用它。

text2image

ByteArtist

通过文字描述生成图片

new_year_pets_image

ByteArtist

提供新春萌宠图片生成，当用户上传宠物图片或者提供图片链接时，可以用此工具生成新的新春萌宠图片

ImageToolPro

ByteArtist

根据用户的描述生成多种风格的图片

LinkReaderPlugin

LinkReader

imgUnderstand

回答用户关于图像的问题

browse

从url链接获取正文信息

search

搜索用户询问的内容

CodeRunner

代码执行器

这个插件将被调用来运行python代码并在60秒内获取结果，尤其处理数学、计算机、图片和文件等。首先，LLM将分析问题，并用python输出解决这个问题的步骤。其次，LLM立即生成代码，按照步骤解决问题。LLM会参考错误消息调整代码，直到成功。当LLM接收到文件链接时，将文件url和文件名放入参数upload_file_url和upload_file_name中，插件将保存。

getToutiaoNews

搜索新闻讯息

web_pilot

WebPilot

WebPilot进行互联网搜索、分析以及数据生成。

bingImageSearch

必应图像搜索API允许您的用户在全球范围内找到图片。

query

WolframAlpha

算式计算，如1+1=2。如果输入的不是数学表达式，需要将输入转换成数学表达式并添加"()"以确保运算的顺序。如果计算失败，尝试再次调用此工具。

DayWeather

墨迹天气

获取指定日期的天气

EmojiMessage

Emojesus

这用于处理用户输入的信息，它将用户输入的信息转换为表情符号，同时在当前消息状态下生成表情符号，并推荐可能需要的表情符号。

EmojiKitchen

Emojesus

将用户发送的两个emoji组合成一个emoji。

EmojiTranslation

Emojesus

将用户输入的信息翻译成表情符号。

EmojiSearch

Emojesus

根据用户当前的消息搜索对应的表情符号。

search

arXiv

帮助用户在arXiv中搜索论文。

company_info

国内股票

显示公司基本信息。接口说明：根据“股票列表”中获取的股票代码，检索上市公司的公司概况。包括公司基本信息、概念、发行信息等。

company_recent_benefits

国内股票

公司最近的利润情况。界面说明：根据“股票榜”中获取的股票代码，获取上市公司过去一年各季度的利润情况。按截止日期倒序排列。

profitability_of_company

国内股票

显示给定公司的季节性盈利能力。接口说明：该接口汇总个股盈利情况，支持“Year_Quarter”查询。年份可以选择1989年至今年，季度可以选择1：第一季度、2：中期报告、3：第三季度、4：年报。例如，“2025_1”表示2025年第一季度的数据。

season_operate_of_company

国内股票

接口说明：个股操作能力汇总，支持按“年_季度”查询。年份可以选择1989年至今年，季度可以选择1：第一季度、2：中期报告、3：第三季度、4：年报。例如，“2025_1”表示2025年第一季度的数据。

season_growth_of_company

国内股票

公司的季节增长。接口说明：该接口汇总了个股的成长能力，支持“Year_Quarter”格式的查询。年份可以选择1989年至今年，季度可以选择1：第一季度、2：中期报告、3：第三季度、4：年报。例如“2025_1”表示查询2025年第一季度的数据。

season_debt_repay_of_company

国内股票

接口说明：个股偿债能力汇总，支持“年_季度”查询。年份可以选择1989年至今年，季度可以选择（1：第一季度报告，2：中期报告，3：第三季度报告，4：年报）。例如“2025_1”表示查询2025年第一季度的数据。

GenPdf

DocMaker

从您提供的文本生成PDF。

getRoute

飞常准

获取航班列表

get_notion_document_info

Notion

获取Notion文件信息

search

中国诗搜索

根据给定条件搜索中国诗

createDocument

飞书云文档

这是一个可以根据用户输入或者要记录的Markdown字符串和总结的标题来创建云文档的工具。

SecondHandCar

懂车帝

当你查询二手车的售卖信息时候可以使用此工具，可以获得二手车的价格、二手车车况图片等信息

CarSeries

懂车帝

当你需要查询新车信息或者查询某个特定车系（如宝马3系，奔驰e级）信息的时候可以使用此工具，可以获得新车价格，车辆结构，车辆生产年份，售卖链接等信息

get_express_info

快递查询助手

获取快递信息。

SearchHotels

猫途鹰

根据城市名称、入住日期和退房日期搜索酒店。

SearchFlights

猫途鹰

根据出发地、目的地、日期、行程类型、排序顺序、成人数量、老年人数量和服务等级搜索航班。

charactor_fate

起名

根据命运给出一个合适的名字。

search_population_density

世界银行

人口密度（每平方公里土地面积的人口数量）。人口密度是年中人口除以平方公里的土地面积。

search_foreign_direct_invest

世界银行

外国直接投资，净流入（国际收支平衡表，当前美元）。外国直接投资是指报告经济体中的直接投资股权流入。它是股本、利润再投资及其他资本的总和。返回的数据单位是1美元。

search_total_population

世界银行

总人口是基于人口的事实定义，计算所有居民，无论法律身份或公民身份如何。显示的值是年中估计值。返回的数据单位是1个个体。

search_income_share_highest_10

世界银行

最高10%的人持有的收入份额。收入或消费的百分比份额是按十分位数或五分位数划分的人口子组所获得的份额。

search_current_account_balance

世界银行

经常账户余额（国际收支平衡表，当前美元）。经常账户余额是货物和服务净出口、初级收入净额和二次收入净额的总和。数据以当前美元计价。返回的数据单位是1美元。

search_gdp_info

世界银行

购买者价格的GDP是经济中所有常住生产者的总价值增加之和，再加上任何产品税收，减去未包含在产品价值中的任何补贴。数据以当前的美元表示。返回的数据单位为1美元。

search_center_gov_debt_gdp

世界银行

中央政府债务总额（占GDP的百分比）。债务是指在特定日期上政府对他人的所有固定期限合约义务的全部储备。它包括国内外的债务，如货币和货币存款、非股份证券和贷款。

search_consumer_price_index

世界银行

消费者价格指数（2010年=100）。消费者价格指数反映的是平均消费者获取一篮子可能固定或在指定间隔（如每年）改变的商品和服务的成本变化。通常使用Laspeyres公式计算。数据为期间平均值。

search_a_country_basic_info

世界银行

搜索国家id，国际代码，首都城市，经度，纬度。特殊提示，您可以一次性通过这个工具获取所有国家的国家id。国家id是这个插件的所有其他工具需要使用的参数。

search_unemployment

世界银行

总失业人数（占劳动力总数的百分比）（国家估计）。失业是指劳动力中没有工作但现有并寻求就业的人口的比例。各国对劳动力和失业的定义不同。

search_gdp_per_capita

世界银行

人均GDP是国内生产总值除以年中人口数。GDP是经济中所有常住生产者的总价值增加之和，再加上任何产品税收，减去未包含在产品价值中的任何补贴。数据以当前的美元表示。返回的数据单位为1美元。

food

食物大师

食物热量查询。输入食物名称，输出其热量。

calories

食物大师

搜索适合输入热量的食物。

create_hanzi_gif

写汉字

为用户创建展示汉字笔顺的gif动画。输入参数必须是中文。

BankInterestRate

国内银行利率

银行利率查询，可查询指定银行的贷款利率、存款利率、公积金利率

job_recommation

猎聘

帮助用户搜索工作招聘，基于用户的工作经验、教育经历、地理位置、薪水、职位名称、工作性质等

ocr

SimpleOCR

图像URL的光学字符识别

lyrics_to_song

AI乐队

根据歌词生成歌曲

searchLocation

地图精灵

周边搜索：用户可以轻松搜索附近的餐厅、娱乐场所以及各种其他餐饮和休闲点，让他们快速找到周围的服务和娱乐选择。

searchDirection

地图精灵

路线推荐：提供高效的路线规划和建议，帮助用户快速找到最佳出行路线，节省时间和精力。

ForexTrPlugin

外汇走势

外汇走势

ExpressDeliveryPlugin

国内快递查询

快递状态查询

SecondHandHouse

幸福里

如果想要购买二手房或者查询二手房信息的时候可以使用此工具，输入二手房的城市、户型、小区名称等，可以获取二手房所在的区域，房子图片，二手房总价，每平米价格等信息

NewHouse

幸福里

如果你想买新房，可以先用这个工具获取新房的信息，输入想要的户型、区域、城市、小区名称等，可以获取新房的具体信息，包括房子图片，价格，每平米价格等

HouseRenting

幸福里

通过此工具获取租房的信息，包括房子所在的区域，小区名称，房子图片，租房的价格

roll_the_dice

骰子大师

掷骰子

get_dice_images

骰子大师

根据输入的整数获取对应值的骰子图像。

count_dice

骰子大师

找到具有某一设定值的骰子数量。（包括可以被视为任何数字的1。）

AddRankConfig

游戏积分排行榜

添加排名配置。

WriteRank

游戏积分排行榜

编写排名。

GetRankInfo

游戏积分排行榜

获取排名信息。

Game

游戏积分排行榜

游戏结束。

自定义插件的步骤非常简单：

在弹出的编辑插件配置窗口中依次配置：插件图标、插件名称、插件描述、插件URL(接口的BaseURL)、Header列表(请求头列表)、授权方式(不需要授权、Service[Token或APIKey]、Oauth)。

插件创建完，就到创建工具了：

填写基本信息：工具名称、工具描述、工具路径(API接口)、请求方式(GET、POST等)；

具体创建的操作流程图解可以看我之前写的《用Coze扣子轻松搭个Bot，从此告别"标题党"》，非常简单，等下也会讲到。我感觉自定义插件的难点，反而是去哪找称心如意的API接口？常规思路无非这几个：

搜索免费/开源接口→如：玩Android开放API、SocialSisterYi/bilibili-API-collect等，这个得自己搜，Github上挺多。

付费接口→如：聚合数据，一般按照调用次数收费，也会提供一定的免费调用次数(如50次/天)。

接口破解→通过抓包、逆向破解APP等方式获取私密API，但谨记偷着乐，这很可刑。

买云服务器自己提供接口→成本较高，首先你得买个云服务器，然后有技术门槛，你起码能能把站点支棱起来，感觉能通过扣子插件获利了，再搞也不迟，当然，你要为爱发电也是可以的。

真的就只有上面几种获取API接口的方式么？嘿嘿，杰哥再给你支个奇招→MockAPI，简单点说就是：定义接口API，每次请求返回写死的数据。

不懂没关系，看我怎么操作就行了，以Apifox为例实现一波~

简单设置下接口地址，加一个分页的请求参数。

然后响应那里就可以看到生成的字段啦：

保存下接口，直接浏览器访问下：

此时访问：

就是第二页的数据啦♪(^∇^*)

接着回到扣子，新建插件，插件url配置成我们的云端Mock的url：

配置下page参数，传入方法要用Query：

接着可以分别输入1、2测试是否为期望的返回结果，如果输入其它值则是根据字段自动生成的数据：

新建一个工作流，测试下我们的自定义插件：

Nice，接着如法炮制添加更多API来完善插件里的插件工具吧！

MockAPI返回的响应数据都是固定，如果想更新，需要自己手动复制新的Json数据去覆盖。对于新闻这类时效性要求比较高的信息，更新频率会有点高，比如：每30分钟需要更新一次，让人手动去更？

妥妥得想办法弄下自动更新，思路：

定时任务还好，网上资料全得很：schedule库，APScheduler库，或者直接用操作系统的任务计划器都行，这其中最重要的一环是Apifox有没有提供API？把文档都翻遍了，终于让我找到了修改接口的API。

importrequestsasrheaders={'X-Apifox-Version':'2025-01-20','Authorization':'BearerAPS-xxx','User-Agent':'Apifox/1.0.0()'}defget_api_info(project_id,api_id):resp=("{}/http-apis/{}".format(project_id,api_id),headers=headers)print()if__name__=='__main__':get_api_info(xxx,xxxxxx)

格式化下接口返回的json，不难看出这就是我们提供的Mock数据列表：

importjsonimportrequestsasr更新api接口defupdate_api(project_id,api_id):request_url="{}/http-apis/{}?locale=zh-CN".format(project_id,api_id)对下不变的参数put_data={"tags":data_json['tags'],"requestBody":data_json['requestBody'],"parameters":data_json['parameters'],"name":data_json['name'],"description":data_json['description'],"method":data_json['method'],"path":data_json['path'],"status":data_json['status'],"projectId":data_json['projectId'],"folderId":data_json['folderId'],"auth":data_json['auth'],"advancedSettings":data_json['advancedSettings'],"responses":data_json['responses'],}更新返回数据responseExamples对应的数据put_data['responseExamples']=[{'name':"成功示例","ordering":1,"data":jh_json}]输出：{"success":true,"data":null}if__name__=='__main__':update_api(xxx,yyy)

运行后，可以看到接口文档的响应数据也更新了！赶紧去试试吧~