@aiagenta2z/agtm 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,305 +1,142 @@
1
- # # AI Agent Marketplace Index| AI Agent Directory | AI Agent Store to Host All Available AI Agents | OneKey AI Agent Router | Agent Moneytization
1
+ ### agtm: Command Line CLI Tool for AI Agent Registry in the Open Source AI Agent Marketplace
2
2
 
3
- [Github](https://github.com/aiagenta2z/ai-agent-marketplace)|[Huggingface](https://huggingface.co/datasets/DeepNLP/AI-Agent-Marketplace-Index)|[Pypi](https://pypi.org/project/ai-agent-marketplace/) | [Open Source AI Agent Marketplace DeepNLP](https://www.deepnlp.org/store/ai-agent)|[Agent RL Dataset](https://www.deepnlp.org/store/dataset)
3
+ [AI Agent Marketplace CLI Doc](https://www.deepnlp.org/doc/ai_agent_marketplace)|[AI Agent Marketplace](https://www.deepnlp.org/store/ai-agent)
4
4
 
5
- This is the official github repo for pypi package ai_agent_marketplace [https://pypi.org/project/ai-agent-marketplace](https://pypi.org/project/ai-agent-marketplace).
6
- The repo Open Source AI Agent Marketplace and deepnlp.org website [AI Agent Marketplace Store & Search Engine](http://www.deepnlp.org/store/ai-agent) aims to provides a public repo and index of more than 10K+ AI Agent information from 30+ categories in the communities, such as autonomous agent, chatbots, Computer and Mobile phone use agents, robotic agents, and various industries such as business, finance, law, medical or healthcare, etc. The directory are updated to websites from both public repo (github/huggingface) as well as AI Agent services in cloud service provider (Microsoft Azure AWS, Copilot, OpenAI Agent app Store GPT Store, Google Cloud, etc).
7
5
 
6
+ The command line `agtm --upload` , `agtm --search` helps users to register and publish their AI Agents meta api information from agent.json/agent.yaml file
7
+ or a github repo URL in a few seconds.
8
8
 
9
- **AI Agent Marketplace Distribution By Category**<br>
10
-
11
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_agent_marketplace_distribution.png" style="height:600px;" alt="AI Agent Marketplace Category">
12
-
13
- We would like to help developers and end users within the lifecycle of AI agent development. From the registration, deployment, Agent router, API calling, metric/traffic tracking, and finally to the stage of moneyterization from your AI Agent. Anyone can submit their AI agents card information, code, APIs, pricing plans to the public registry, just like your submit a paper to arxiv.org and submit models to huggingface.co.
14
-
15
- ```mermaid
9
+ 'agtm' means 'ai agent marketplace' or 'ai agent manager'
10
+ To use the command line, you need to first install the package either using python or node environment
16
11
 
17
- graph LR
18
-
19
- Dev[Developers]--> A[AI Agent/MCP Development] --> B[Deloyment] --> C[AI Agent Registry to Marketplace] --> D[Agent Search and Exploration]
20
12
 
21
- U[Users] --> R[Agent Router & Data Tracking] --> F[API Billing System​] --> G[Feedback Comments & Discussion] --> H[Moneytization]
22
13
 
14
+ #### Install and Use `agtm` CLI
15
+ Python
16
+ ``` Python
17
+ pip install ai-agent-marketplace
23
18
  ```
24
19
 
25
- # Main Features
26
- 1. **AI Agent Registry**: You can submit your AI Agent's meta to the [Official AI Agent Marketplace Registry](https://www.deepnlp.org/workspace/my_ai_services) directly on website or using various methods (python,nodejs, curl, etc). After submitting your AI Agent meta and approval, community will find your AI Agent in each categories. We also host available submission from various agent store or build in any infrastractures, such as OpenAI Apps SDK, Claude MCPs, etc.
27
- 2. **AI Agent Search Engine and Search API**: Users are able to search and explore your AI Agent through [AI Agent Search Engine](https://www.deepnlp.org/search/agent) and you can also access the AI Agent Meta Index through [Search API](https://www.deepnlp.org/doc/ai_agent_marketplace) and [MCP servers](https://github.com/aiagenta2z/ai-agent-marketplace-index-mcp) also.
28
- 3. **OneKey Agent Router**: [OneKey Agent Router](https://www.deepnlp.org/agent/onekey-ai-agent-router) aims to router users' request to your AI Agent or MCPs' registered http APIs using only one access key authentication, which can help users simplify their registration process. We initialize a OneKey revenue sharing credit plans to help you gain from the free-tier users.
29
- 4. **Traffic Tracking**: Traffic tracking service to your AI Agents, ranging from API calls from the OneKey Router,GitHub Stars,Google/Bing search engine rankings,
30
- 5. **Users Genunie Reviews & Discussion**: Users can sort the AI Agent meta by reviews, ratings and find good AI Agent of different categories.
31
- 6. **AI Agent Moneyterization**: Getting payment account for your AI Agent is not easy, we provides Stripe, Alipay, Credit card payment methods based on a unified credit charging system and and you can gain credits in your billing account from users' request. You can purchase datasets, call LLM and commercial MCPs (Google Maps, Google Search, etc) and withdraw.
32
- 7. **Dataset for Research**: We provide full snapshot of AI Agent Marketplace dataset periodically back to the community on [Huggingface](https://huggingface.co/datasets/DeepNLP/AI-Agent-Marketplace-Index), so researchers can track the growth.
33
-
34
-
35
- **AI Agent Marketplace and Search Engine**<br>
36
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/AI%20Agent%20Marketplace%20Search.jpg" style="height:300px;" alt="AI Agent Marketplace Index and Search">
37
-
38
- **AI Agent Registration**<br>
39
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_agent_registry.jpg" style="height:300px;" alt="AI Agent Registry">
40
-
41
- **AI Agent Calls Credit Usage**<br>
42
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_agent_credit.jpg" style="height:300px;" alt="AI Agent Registry">
43
-
44
- **Traffic Tracking**<br>
45
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_search_ranking_chart.jpg" style="height:300px;">
20
+ Node
21
+ ``` NodeJS
22
+ npm install -g @aiagenta2z/agtm
23
+ ```
46
24
 
47
- **OneKey Router**<br>
48
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/onekey_api_router.jpg" style="height:300px;" alt="AI Agent OneKey Router">
25
+ note: run nodejs environment, you need to add -g to install, so you can just run command line `agtm` without the `npx agtm` prefix,
49
26
 
50
- **Users Genunie Reviews**<br>
51
- <img src="https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_agent_user_reviews.jpg" style="height:300px;">
52
27
 
28
+ Command line to register your AI agent from GitHub, Local config(agent.json, agent.yaml) or search the AI agent marketplace.
29
+ To see detailed usage, visit the GitHub of `agtm` at Documentation (https://github.com/aiagenta2z/ai-agent-marketplace)
53
30
 
54
- ## Short Cut to AI Agent Marketplace Markdown
55
- - [AI AGENT Marketplace Collection](./AGENT.md)
56
- - [Email Writing AI Agent](./AGENT.md#email-writing-ai-agent)
57
- - [BENCHMARK AI Agent](./AGENT.md#benchmark-ai-agent)
58
31
 
32
+ #### Tutorial
59
33
 
60
- ## Usage
61
- 1. **AI Agent Registry**
34
+ Let's say you have create a repo of your open source AI Agent (e.g. https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent), And you want to
35
+ register and get a registered detailed page of AI Agent in the marketplace and monitor the traffic.
62
36
 
63
- List of Methods that you can register your AI agent
37
+ **1. Setup Access Key**
64
38
 
65
- | method | usage |
66
- |-------------|----------------------------------------------------------------------------------------------------------------------|
67
- | Website | Visit the [official AI Agent registry](https://www.deepnlp.org/workspace/my_ai_services) |
68
- | curl | Support to Submit your Github Repo contents to the marketplace |
69
- | Command CLI | You can use command line `agtm --upload` to register your AI agent, and `agtm --search` to explore various AI agents |
70
- | python | Install packages `pip install ai_agent_marketplace` |
71
- | nodejs | Install packages `npm install -g @aiagenta2z/agtm` |
39
+ First you need to setup an access_key in the environment to authenticate.
40
+ Register your AI Agent Marketplace Access Key here (https://deepnlp.org/workspace/keys)
72
41
 
42
+ ```
43
+ export AI_AGENT_MARKETPLACE_ACCESS_KEY="{your_access_key}"
44
+ ```
73
45
 
74
- ### Curl
46
+ **2. Registry AI Agent from your GitHub**
75
47
 
76
- Best suitable when you already put your AI Agent introduction on github and you can just curl to the registry.
48
+ The default registry provider endpoint includes: [DeepNLP AI Agent Registry Endpoint](https://www.deepnlp.org/api/ai_agent_marketplace/registry) |
49
+ [aiagenta2z.com Registry Endpoint](https://www.aiagenta2z.com/api/ai_agent_marketplace/registry)|[aiagenta2z.org Registry Endpoint](https://www.aiagenta2z.org/api/ai_agent_marketplace/registry), etc.
77
50
 
78
- Let's say you want to submit an MCP github repo, we use the markitdown repo for example: https://github.com/microsoft/markitdown.
51
+ You can also set your customized registry endpoint via `--endpoint` parameter
79
52
 
80
- Firstly, get the keys from [Keys Generation](https://www.deepnlp.org/workspace/keys) generate `AI_AGENT_MARKETPLACE_ACCESS_KEY` as developer.
81
53
 
82
54
  ```
83
- curl -X POST https://www.deepnlp.org/api/ai_agent_marketplace/registry -H "Content-Type: application/json" -d '{"github":"https://github.com/microsoft/markitdown", "access_key":"{AI_AGENT_MARKETPLACE_ACCESS_KEY}"}'
55
+ agtm upload --github https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent
84
56
  ```
85
57
 
86
58
 
87
- ### Command Line CLI
88
-
89
- The command line `agtm --upload` , 'agtm' means 'ai agent marketplace' or 'ai agent manager'
90
- To use the command line, you need to first install the package either using python or node environment
91
-
92
- #### Install and Use `agtm` CLI
93
- ``` Python
94
- pip install ai_agent_marketplace
95
- ```
96
- or
97
- ``` NodeJS
98
- npm install -g @aiagenta2z/agtm
99
- ```
59
+ **3. Registry AI Agent from agent.json or agent.yaml file**
100
60
 
101
- Command line to register your AI agent from GitHub, Local config(agent.json, agent.yaml) or search the AI agent marketplace.
102
- To see detailed usage, visit the GitHub of `agtm` at (https://github.com/aiagenta2z/ai-agent-marketplace)
103
61
 
104
- First you need to setup an access_key in the environment to authenticate.
105
- Register your AI Agent Marketplace Access Key here (https://deepnlp.org/workspace/keys)
106
62
  ```
107
- export AI_AGENT_MARKETPLACE_ACCESS_KEY="${your_access_key}"
108
- agtm upload --github https://github.com/aiagenta2z/ai-agent-marketplace
109
63
 
110
- ## Or register from local config of AI Agent meta
64
+ ## Register from local config of AI Agent meta
111
65
  agtm upload --config ./agent.json
112
66
  agtm upload --config ./agent.yaml
113
67
 
114
- ## Search Open Source AI Agent marketplace of deepnlp
115
- agtm search --q 'coding agent'
116
- agtm search --id 'google-maps/google-maps'
117
68
 
69
+ ## Submit to your customized endpoint
70
+
71
+ agtm upload --config ./agent.yaml --endpoint https://www.example.com
118
72
  ```
119
73
 
120
- ### Python
121
74
 
122
- #### Install
123
- ```
124
- pip install ai_agent_marketplace
75
+ You can download sample [agent.json](https://github.com/aiagenta2z/agtm/agent.json) or [agent.yaml](https://github.com/aiagenta2z/agtm/agent.yaml) file from github https://github.com/aiagenta2z/agtm
76
+ See the explanation of the schema, please visit the [documentation](https://www.deepnlp.org/doc/ai_agent_marketplace).
125
77
 
126
- ```
127
78
 
128
- Get [Keys](https://deepnlp.org/workspace/keys) and Register your AI Agent
129
- ```
130
- export AI_AGENT_MARKETPLACE_API_KEY={Your API Key}
79
+ Demo agent.json file
131
80
  ```
132
-
133
- submit your AI Agent
81
+ {
82
+ "name": "My First AI Coding Agent",
83
+ "content": "This AI Agent can do complicated programming work for humans",
84
+ "website": "https://www.my_first_agent.com",
85
+ "field": "AI AGENT",
86
+ "subfield": "Coding Agent",
87
+ "content_tag_list": "coding,python",
88
+ "github": "",
89
+ "thumbnail_picture": "https://avatars.githubusercontent.com/u/242328252?s=200&v=4",
90
+ "upload_image_files": "",
91
+ "api": "https://www.my_first_agent.com/agent",
92
+ "price_type": "PER_CALL",
93
+ "price_per_call_credit": 0.0,
94
+ "price_fixed_credit" : 0.0,
95
+ "price_subscription": "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
96
+ }
134
97
  ```
135
- import ai_agent_marketplace as aa
136
- import json
137
-
138
- def publish_your_agent():
139
- """
140
- access_key can be obtained from your personal page:
141
- www.deepnlp.orgworkspace/my_ai_services
142
- once you submit, it's pending approval and you can track the data then
143
- get your access_key from http://www.deepnlp.org/workspace/my_ai_services
144
- """
145
- access_key = "${your_access_key}"
146
- name = "My First AI Agent"
147
-
148
- item_info = {}
149
- item_info["content"] = "This AI Agent can do complicated programming work for humans"
150
- item_info["website"] = "https://www.my_first_agent.com"
151
- item_info["field"] = "AI AGENT"
152
- item_info["subfield"] = "Coding Agent"
153
- item_info["content_tag_list"] = "coding,python"
154
- result = aa.add(access_key=access_key, name="My First Agent", item_info=item_info)
155
- url = result["url"] if "url" in result else ""
156
- msg = result["msg"] if "msg" in result else ""
157
- print ("## DEBUG: AI Agent Marketplace Post msg is|%s" % str(msg))
158
- print ("## DEBUG: AI Agent Marketplace Post url is|%s" % str(url))
159
-
160
-
161
- publish_your_agent()
98
+ Demo agent.yaml file
162
99
  ```
163
100
 
164
- ### NodeJs(NPX/NPM)
165
- Install the package of 'ai_agent_marketplace' or 'agtm' for short.
166
- ``` NodeJS
167
- npm install -g @aiagenta2z/agtm
101
+ name: "My First AI Coding Agent"
102
+ content: "This AI Agent can do complicated programming work for humans"
103
+ website: "https://www.my_first_agent.com"
104
+ field: "AI AGENT"
105
+ subfield: "Coding Agent"
106
+ content_tag_list: "coding,python"
107
+ github: "https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent"
108
+ thumbnail_picture: "https://avatars.githubusercontent.com/u/242328252?s=200&v=4"
109
+ upload_image_files: ""
110
+ api: "https://www.my_first_agent.com/agent"
111
+ price_type: "API Call"
112
+ price_per_call_credit: 0.0
113
+ price_fixed_credit: 0.0
114
+ price_subscription: "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
115
+
168
116
  ```
169
117
 
170
- AI Agent Registry using `agtm`
118
+ **4. Search AI Agent Marketplace**
171
119
 
172
120
  ```
173
- export AI_AGENT_MARKETPLACE_ACCESS_KEY="${your_access_key}"
174
- agtm upload --github https://github.com/aiagenta2z/ai-agent-marketplace
175
121
 
176
- ## Or register from local config of AI Agent meta
177
- agtm upload --config ./agent.json
178
- agtm upload --config ./agent.yaml
179
- ```
122
+ ## Search Open Source AI Agent marketplace of deepnlp
180
123
 
181
- AI Agent Marketplace Search using `agtm` and nodejs
182
- ```
183
124
  agtm search --q 'coding agent'
184
125
  agtm search --id 'google-maps/google-maps'
126
+ agtm search --id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
185
127
  ```
186
128
 
187
- 2. **AI Agent Search Engine and Search API**:
188
-
189
-
190
- We provides both API and python package wrapper
129
+ Search Result of query q="coding agent"
191
130
 
192
131
  ```
193
-
194
- import ai_agent_marketplace as aa
195
- import json
196
-
197
- def search_ai_agent_traffic_data():
198
-
199
- result = aa.search(q="Coding Agent Jetbrains")
200
- print ("## DEBUG: search result is|%s" % str(result))
201
-
202
- result2 = aa.search(q="Coding Agent", limit=20, timeout=5)
203
- print ("## DEBUG: search result is|%s" % str(result2))
204
-
205
- result3 = aa.search(q="", limit=20, timeout=5)
206
- print ("## DEBUG: search result is|%s" % str(result3))
207
-
208
- search_ai_agent_traffic_data()
209
-
132
+ [{'content_name': 'Cursor AI', 'publisher_id': 'pub-cursor', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-cursor/cursor-ai', 'website': 'https://docs.cursor.com/agent', 'github': '', 'review_cnt': '3', 'rating': '3.3', 'description': 'Cursor AI Coding Editor provides Agent mode, which is the default mode in Cursor, equipped with all tools to efficiently handle a wide range of coding tasks. Agent is the default mode in Cursor that is best for most tasks. It has all tools enabled to allow it to perform all operations necessary to complete the task at hand. Make sure to read chat overview to learn more about how modes work in Curs', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'cursor/cursor-ai', 'content_tag_list': 'Coding Agent,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/a7dd95e7eb419437ef4a91f4b0e853cb.jpg'}, {'content_name': 'trae ai', 'publisher_id': 'pub-trae-ai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-trae-ai/trae-ai', 'website': 'https://www.trae.ai/', 'github': '', 'review_cnt': '2', 'rating': '4.0', 'description': 'Trae AI IDE is a cutting-edge AI-integrated development environment designed to enhance developer productivity by leveraging advanced AI models like Claude3.5 and GPT-4o. It offers a seamless coding experience with features such as intelligent code generation, real-time feedback, and multi-modal input support, making it a powerful tool for developers. Introduction Trae AI IDE, developed by ByteDan', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'trae-ai/trae-ai', 'content_tag_list': 'CODING AGENT,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/cc43d2dc25488b50b883781e0ae8c988.png'}, {'content_name': 'codex', 'publisher_id': 'pub-openai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-openai/codex', 'website': 'https://github.com/openai/codex', 'github': 'https://github.com/openai/codex', 'review_cnt': '1', 'rating': '5.0', 'description': 'npm i -g @openai/codexor brew install --cask codex\n\nCodex CLI is a coding agent from OpenAI that runs locally on your computer.\n\nIf you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE\nIf you are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex\n\n\n \n \n\n---\n\n## Quickstart\n\n### Installing and running Codex CLI\n\nInstall globally with yo', 'subfield': 'CODING AGENT', 'field': 'AI AGENT', 'id': 'openai/codex', 'content_tag_list': 'GitHub 48.6k', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/14957082?v=4'}, {'content_name': 'fine dev', 'publisher_id': 'pub-fine-dev', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-fine-dev/fine-dev', 'website': 'https://www.fine.dev', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': 'Full-Stack AI Developer Agent for Startups Accelerate your startup’s release schedule and ship daily improvements. Fine is the AI Coding Agent built to act like another team member, getting work done. Try free or watch it work.', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'fine-dev/fine-dev', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://www.fine.dev/_next/static/media/logo.76f79362.svg'}, {'content_name': 'claude code', 'publisher_id': 'pub-claude-code', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-claude-code/claude-code', 'website': 'https://www.anthropic.com/claude-code', 'github': '', 'review_cnt': '1', 'rating': '5.0', 'description': 'Claude Code by Anthropic is an AI-powered coding assistant designed to enhance developer productivity by providing intelligent code generation, debugging, and optimization capabilities. It integrates seamlessly with various developer tools, making it easy to use within existing workflows. Introduction Claude Code is a powerful AI coding assistant developed by Anthropic, aimed at helping developers', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'claude-code/claude-code', 'content_tag_list': 'CODING AGENT,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/7d6c735321396b42b5c2e46499e17a6e.png'}, {'content_name': 'qwen code', 'publisher_id': 'pub-qwen-code', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-qwen-code/qwen-code', 'website': '', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': 'Qwen Coding Agent offers an advanced framework for developing applications utilizing large language models (LLMs), enhancing capabilities such as instruction following, tool usage, planning, and memory. Introduction Qwen Coding Agent provides a robust platform for building LLM applications, leveraging the advanced features of Qwen models (version 2.0 and above). It facilitates the development of i', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'qwen-code/qwen-code', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://camo.githubusercontent.com/db544c14e8419ecf289564a79841e005c518fc29cd418ac4a31215e9377eaa22/68747470733a2f2f7169616e77656e2d7265732e6f73732d636e2d6265696a696e672e616c6979756e63732e636f6d2f5177656e322e352f5177656e322e352d436f6465722f7177656e322e352d636f6465722d6c6f676f'}, {'content_name': 'Qoder', 'publisher_id': 'pub-qoder', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-qoder/qoder', 'website': 'https://qoder.com/download', 'github': '', 'review_cnt': '1', 'rating': '5.0', 'description': '\r\n## Qoder\r\n\r\nQoder is an agentic coding platform designed for real software development. It seamlessly integrates enhanced context engineering with intelligent agents to gain a comprehensive understanding of your codebase and systematically tackles software development tasks.\r\nIt goes beyond simple code completion-Qoder helps you think deeper, code smarter, and build better by automating intricat', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'qoder/qoder', 'content_tag_list': 'coding,agent', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/6d7c68c43f520b76251fe2ac7c0061a8.jpg'}, {'content_name': 'CodeBuddy IDE Tencent', 'publisher_id': 'pub-tencent', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-tencent/codebuddy-ide-tencent', 'website': 'https://copilot.tencent.com/ide', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': '\r\nCodeBuddy IDE Tencent AI 一站式工作台:从此用自然语言实现产品、设计、研发全流程\r\n\r\n\r\n\r\n## AI 智能代码补全\r\n所想即所码\r\nAI驱动的实时代码预测与智能补全,让编程如行云流水\r\n\r\n\r\n## AI 设计生成\r\n草图秒变原型\r\n手绘概念瞬间转化为高保真交互原型,创意无需等待\r\n\r\n## 设计稿转代码\r\n一稿生万码\r\nFigma设计 稿一键转换为生产级代码,还原度高达99.9%\r\n\r\n\r\n## AI 全栈开发\r\n你的AI编程搭档\r\n智能开发代理,自主完成多文件代码生成与重构\r\n\r\n\r\n## 内置后端服务\r\n后端开 发零门槛\r\n内置腾讯云 CloudBase 和 Supabase服务,数据库与用户认证一键搞定\r\n\r\n## 一键部署分享\r\n开发、部署、分享,一键搞定\r\n内置 Cloud Studio,EdgeOne Pages,从开发环境到在线演示,只需一秒钟', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'tencent/codebuddy-ide-tencent', 'content_tag_list': 'ide,coding agent', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/3ef7d0e02ecbf36eb9dbd25590c7c87e.jpg'}, {'content_name': 'zencoder ai', 'publisher_id': 'pub-zencoder-ai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-zencoder-ai/zencoder-ai', 'website': 'https://zencoder.ai', 'github': '', 'review_cnt': '0', 'rating': '0.0', 'description': "Zencoder AI provides a range of AI agents designed to streamline and enhance various business processes through intelligent automation and advanced AI capabilities. Introduction Zencoder AI's AI agents are built to act as digital assistants, automating complex tasks and improving operational efficiency across multiple industries. These agents leverage cutting-edge AI technologies to handle tasks s", 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'zencoder-ai/zencoder-ai', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://zencoder.ai/favicon.ico'}, {'content_name': 'gpt-engineer', 'publisher_id': 'pub-antonosika', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-antonosika/gpt-engineer', 'website': 'https://github.com/AntonOsika/gpt-engineer', 'github': 'https://github.com/AntonOsika/gpt-engineer', 'review_cnt': '0', 'rating': '0.0', 'description': '# gpt-engineer\n\n](https://github.com/gpt-engineer-org/gpt-engineer)\n](https://discord.gg/8tcDQ89Ej2)\n](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/LICENSE)\n](https://github.com/gpt-engineer-org/gpt-engineer/issues)\n\n](https://twitter.com/antonosika)\n\nThe OG code genereation experimentation platform!\n\nIf you are looking for the evolution that is an opinionated, managed service – chec', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'antonosika/gpt-engineer', 'content_tag_list': 'GitHub 55.0k,ai,autonomous-agent,code-generation,codebase-generation,codegen,coding-assistant,gpt-4,gpt-engineer,openai,python', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/4467025?v=4'}]
210
133
  ```
211
134
 
212
- For example, we use the AI Agent MCP server [Google Maps MCP Servers](https://www.deepnlp.org/store/mcp-server/map/pub-google-maps/google-maps) as example.
213
-
214
- The unique_id should follow the same /{owerid}/{item-id} format
135
+ Search Result of Retrieving registered project id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
215
136
 
216
137
  ```
217
- {
218
- "unique_id": "google-maps/google-maps",
219
- "content_name": "Google Maps MCPs",
220
- "content": "Google Maps MCPs provides Location Service to support various APIs..."
221
- "category": "Map",
222
- "field": "MCP SERVER",
223
- "subfield": "Map",
224
- "content_tag_list": "official",
225
- "website": "maps.google.com",
226
- "content_tag_list": "maps,location"
227
- "github": "https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps"
228
- }
229
- ```
230
-
231
- ### NodeJs
232
- TBD
233
-
234
-
235
- 3. OneKey Agent Router
236
-
237
- Try Web App of Onekey [API Router Agent](https://agent.deepnlp.org/agent/mcp_tool_use)
238
-
239
-
240
-
241
-
242
- 4. **Traffic and API Usage Tracking**
243
-
244
- ### Key Metrics
245
- Some of the key metric that DeepNLP AI Agent Marketplace monitors include:
246
-
247
- - Bing/Google search result ranking
248
- - IOS Android App Store Ranking
249
- - Github Repo Ranking
250
- - etc
251
-
252
- ![AI Agent Navigation](https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_agents_navigation.jpg)
253
-
254
- You can visit [DeepNLP AI Agent Marketplace and Directory](http://www.deepnlp.org/store/ai-agent) to find more.
255
-
256
- #### Search Ranking Performance
257
-
258
- Suppose you want to find out some suitable AI Employees which can help you write reports or emails, schedule meeting, write codes, etc. You may use Google or Bing to search keywords like "AI Agent Employees", "Report Writing Agents", "Coding Agents", etc. And DeepNLP AI Agents Marketplace helps you monitor the AI Agents search results ranking. You can navigate to the "Email writing" tab of the AI Agent Directory and see the top reviewed AI Agents and its latested Bing Search Ranking.
259
-
260
- And you can navigate the [Email Writing AI Agents Directory](http://www.deepnlp.org/store/ai-agent?tag=Email%20Writing) and find out some top rated AI Agents in Email Writing such as
261
-
262
- ![Email Writing AI Agents](https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/image_email_writing_agents.jpg)
263
-
264
-
265
- - [mailmeteor.com](http://www.deepnlp.org/store/ai-agent/email-writing/pub-mailmeteor-com/mailmeteor-com)
266
- Bing Search Rank 2.0
267
-
268
- - [galaxy.ai](http://www.deepnlp.org/store/ai-agent/email-writing/pub-galaxy-ai/galaxy-ai)
269
- Bing Search Rank 3.0
270
-
271
-
272
- The metric of Bing search results of AI agents are calculated on various related keywords and updated daily. And you can monitor the daily trends of fast growing AI agents.
273
-
274
- ![Bing Search Ranking Trakcing Email Writing AI Agents](https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/image_email_meteor.jpg)
275
-
276
-
277
- #### Github Performance
278
-
279
- Some of the AI Agents are public available and you can use github to help you track the performance and help you find the best open source AI agents. You can visit the [AI Agent Directory of Coding Agents](http://www.deepnlp.org/store/ai-agent?tag=Coding%20Agent) and help you monitor the performance such as github repo stars.
280
- [List of AI Coding Agent](https://www.deepnlp.org/store/ai-agent/coding-agent)
281
-
282
- ![Coding AI Agents](https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/image_coding_agents.jpg)
283
-
284
-
285
- Can you can find the popular stared Github projects such as:
286
-
287
- - [Vanna AI](http://www.deepnlp.org/store/ai-agent/ai-agent/pub-vanna-ai/vanna-ai)
288
- - [Cody](http://www.deepnlp.org/store/ai-agent/ai-agent/pub-cody-by-sourcegraph/cody-by-sourcegraph)
289
- - [Taskweaver from microsoft](http://www.deepnlp.org/store/ai-agent/coding-agent/pub-taskweaver-microsoft/taskweaver-microsoft)
290
-
291
- ![Taskweaver Agent Marketplace Tracking Github Star](https://github.com/aiagenta2z/ai-agent-marketplace/blob/main/docs/image_task_weaver_microsoft.jpg)
292
-
293
-
294
- #### Dataset and API to Access the AI Agent
295
-
296
- ![AI Agent Index for tracking Daily Search Metric](https://raw.githubusercontent.com/aiagenta2z/ai-agent-marketplace/refs/heads/main/docs/ai_search_ranking_chart.jpg)
297
-
298
- |Snapshot| Dataset |
299
- | 2025-10 | https://huggingface.co/datasets/DeepNLP/AI-Agent-Marketplace-Index |
300
-
301
- ## Contributing
302
-
303
- Please contribute to the AGENT.md to include links and introduction to your repo.
138
+ Retrieving specific agent with unique ID: AI-Hub-Admin/My-First-AI-Coding-Agent
304
139
 
140
+ {'total_hits': 1, 'id': 'AI-Hub-Admin/My-First-AI-Coding-Agent', 'items': [{'content_name': 'My-First-AI-Coding-Agent', 'publisher_id': 'pub-ai-hub-admin', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-ai-hub-admin/my-first-ai-coding-agent', 'website': 'https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent', 'github': 'https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent', 'review_cnt': '0', 'rating': '0.0', 'description': '# My-First-AI-Coding-Agent\nAI Agent Registry Demo project\n\n', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'ai-hub-admin/my-first-ai-coding-agent', 'content_tag_list': 'GitHub 0', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/184629057?v=4'}]}
141
+ ```
305
142
 
package/agent.json CHANGED
@@ -9,7 +9,7 @@
9
9
  "thumbnail_picture": "https://avatars.githubusercontent.com/u/242328252?s=200&v=4",
10
10
  "upload_image_files": "",
11
11
  "api": "https://www.my_first_agent.com/agent",
12
- "price_type": "API Call",
12
+ "price_type": "PER_CALL",
13
13
  "price_per_call_credit": 0.0,
14
14
  "price_fixed_credit" : 0.0,
15
15
  "price_subscription": "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
package/agent.yaml CHANGED
@@ -4,7 +4,7 @@ website: "https://www.my_first_agent.com"
4
4
  field: "AI AGENT"
5
5
  subfield: "Coding Agent"
6
6
  content_tag_list: "coding,python"
7
- github: ""
7
+ github: "https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent"
8
8
  thumbnail_picture: "https://avatars.githubusercontent.com/u/242328252?s=200&v=4"
9
9
  upload_image_files: ""
10
10
  api: "https://www.my_first_agent.com/agent"
package/dist/agtm-cli.js CHANGED
@@ -1,62 +1,35 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || (function () {
19
- var ownKeys = function(o) {
20
- ownKeys = Object.getOwnPropertyNames || function (o) {
21
- var ar = [];
22
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
- return ar;
24
- };
25
- return ownKeys(o);
26
- };
27
- return function (mod) {
28
- if (mod && mod.__esModule) return mod;
29
- var result = {};
30
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
- __setModuleDefault(result, mod);
32
- return result;
33
- };
34
- })();
35
- var __importDefault = (this && this.__importDefault) || function (mod) {
36
- return (mod && mod.__esModule) ? mod : { "default": mod };
37
- };
38
- Object.defineProperty(exports, "__esModule", { value: true });
39
- const commander_1 = require("commander");
40
- const axios_1 = __importDefault(require("axios"));
41
- const fs = __importStar(require("fs"));
42
- const yaml = __importStar(require("js-yaml"));
1
+ #!/usr/bin/env node
2
+ import { Command } from 'commander';
3
+ import axios from 'axios';
4
+ import * as fs from 'node:fs';
5
+ import * as yaml from 'js-yaml';
43
6
  // --- Configuration ---
44
7
  const BASE_URL = 'https://www.deepnlp.org/api/ai_agent_marketplace';
45
- const REGISTRY_ENDPOINT = `https://www.deepnlp.org/api/ai_agent_marketplace/registry`;
46
- const SEARCH_ENDPOINT = `${BASE_URL}/api/ai_agent_marketplace/v2`; // Assuming a search endpoint exists
8
+ const REGISTRY_ENDPOINT = `${BASE_URL}/registry`;
9
+ const REGISTRY_ENDPOINT_v1 = `${BASE_URL}/v1`;
10
+ const SEARCH_ENDPOINT = `${BASE_URL}/v2`; // Assuming a search endpoint exists
47
11
  const ACCESS_KEY_ENV_VAR = 'AI_AGENT_MARKETPLACE_ACCESS_KEY';
12
+ const MOCK_RETURN_URL = "https://www.deepnlp.org/store/ai-agent/ai-agent/pub-AI-Hub-Admin/my-first-ai-coding-agent";
48
13
  // --- Utility Functions ---
49
14
  /**
50
15
  * Retrieves the access key from environment variables.
51
16
  */
52
17
  function getAccessKey() {
53
18
  const key = process.env[ACCESS_KEY_ENV_VAR];
54
- if (!key || key === '{AI_AGENT_MARKETPLACE_ACCESS_KEY}') {
19
+ if (!key) {
55
20
  console.error(`\n❌ Error: Access key not found.`);
56
21
  console.error(`Please set the environment variable '${ACCESS_KEY_ENV_VAR}'.`);
57
22
  console.error('You can get your access key from: https://deepnlp.org/workspace/keys');
58
23
  process.exit(1);
59
24
  }
25
+ else if (key === '{AI_AGENT_MARKETPLACE_ACCESS_KEY}' || key === '{your_access_key}') {
26
+ console.log(`\n Your Input key variable AI_AGENT_MARKETPLACE_ACCESS_KEY ${key} is mock key, Will Return a mock result. Please register and get your keys at https://www.deepnlp.org/workspace/keys. Detail Usage for Documentation: https://www.deepnlp.org/doc/ai_agent_marketplace...`);
27
+ console.log("\n✅ Registration Successful!");
28
+ console.log(` URL: ${MOCK_RETURN_URL}`);
29
+ console.log(` Message: Your Input key is mock key, Will Return a mock result. `);
30
+ console.log(` Track its status at: ${MOCK_RETURN_URL} or submit your AI Agent registry through online website https://www.deepnlp.org/workspace/my_ai_services`);
31
+ process.exit(1);
32
+ }
60
33
  return key;
61
34
  }
62
35
  /**
@@ -87,10 +60,12 @@ function loadConfigFile(filePath) {
87
60
  async function handleUpload(options) {
88
61
  const access_key = getAccessKey();
89
62
  let item_info = {};
90
- const url = options.endpoint || REGISTRY_ENDPOINT;
63
+ // set default registry endpoint and then change according to github/other configs
64
+ var internal_endpoint = REGISTRY_ENDPOINT;
91
65
  if (options.github) {
92
66
  console.log(`\nAttempting to register agent from GitHub: ${options.github}`);
93
67
  item_info.github = options.github;
68
+ internal_endpoint = REGISTRY_ENDPOINT;
94
69
  }
95
70
  else if (options.config) {
96
71
  console.log(`\nAttempting to register agent from config file: ${options.config}`);
@@ -101,17 +76,25 @@ async function handleUpload(options) {
101
76
  process.exit(1);
102
77
  }
103
78
  item_info = file_content;
79
+ internal_endpoint = REGISTRY_ENDPOINT_v1;
104
80
  }
105
81
  else {
106
82
  // Should be handled by commander's required option check, but kept as safeguard.
107
83
  console.error("❌ Error: 'upload' command requires either --github or --config.");
108
84
  process.exit(1);
109
85
  }
86
+ // decide endpoint
87
+ // if github mode, set to REGISTRY_ENDPOINT, otherwise if config mode set to REGISTRY_ENDPOINT_v1
88
+ // if endpoint set externally, has higher priority.
89
+ const url = options.endpoint || internal_endpoint;
90
+ // console.log(`DEBUG: options.endpoint ${options.endpoint}`);
91
+ // console.log(`DEBUG: internal_endpoint ${internal_endpoint}`);
92
+ // console.log(`DEBUG: final url ${url}`);
110
93
  // Prepare payload (combining item info and access key)
111
94
  const payload = { ...item_info, access_key };
112
95
  console.log(`Submitting agent information to endpoint: ${url}`);
113
96
  try {
114
- const response = await axios_1.default.post(url, payload, {
97
+ const response = await axios.post(url, payload, {
115
98
  headers: { 'Content-Type': 'application/json' },
116
99
  // Set a reasonable timeout
117
100
  timeout: 10000
@@ -145,29 +128,28 @@ async function handleUpload(options) {
145
128
  async function handleSearch(options) {
146
129
  const { q, id, countPerPage } = options;
147
130
  if (!q && !id) {
148
- console.error("❌ Error: 'search' command requires either -q (query) or --id (Agent ID).");
131
+ console.error("❌ Error: 'search' command requires either --q (query) or --id (Agent ID).");
149
132
  process.exit(1);
150
133
  }
134
+ var defaultSearchMode = "dict";
151
135
  const searchParams = new URLSearchParams();
152
136
  if (q)
153
137
  searchParams.append('q', q);
154
138
  if (id)
155
139
  searchParams.append('id', id.toString());
156
140
  searchParams.append('count_per_page', (countPerPage || 10).toString());
141
+ searchParams.append('mode', defaultSearchMode);
157
142
  const url = `${SEARCH_ENDPOINT}?${searchParams.toString()}`;
158
143
  console.log(`\nSearching marketplace at: ${url}`);
159
144
  try {
160
- const response = await axios_1.default.get(url, { timeout: 10000 });
145
+ const response = await axios.get(url, { timeout: 10000 });
161
146
  const results = response.data;
162
- console.log(`\n✅ Search Complete. Found ${results.length || 0} agents.`);
163
- if (results.length) {
164
- // Simplified output for CLI
165
- results.slice(0, countPerPage || 10).forEach((agent) => {
166
- console.log(`- ID: ${agent.id || 'N/A'}, Name: ${agent.name || 'N/A'}, Field: ${agent.field || 'N/A'}`);
167
- });
168
- if (results.length > (countPerPage || 10)) {
169
- console.log(`...showing first ${countPerPage || 10} results.`);
170
- }
147
+ if (results != null) {
148
+ console.log(`\n✅ Search Complete.`);
149
+ console.log(`\n${JSON.stringify(results, null, 2)}`);
150
+ }
151
+ else {
152
+ console.log(`\n✅ Search Complete. Found Empty results.`);
171
153
  }
172
154
  }
173
155
  catch (e) {
@@ -177,7 +159,7 @@ async function handleSearch(options) {
177
159
  }
178
160
  }
179
161
  // --- CLI Setup (Commander) ---
180
- const program = new commander_1.Command();
162
+ const program = new Command();
181
163
  program
182
164
  .name('agtm')
183
165
  .description('An Open Source Command-line Tool for AI Agents meta registry, AI Agents Marketplace Management, AI Agents Search and AI Agents Index Services. Help users to explore interesting AI Agents. Documentation: https://www.deepnlp.org/doc/ai_agent_marketplace, Marketplace: https://www.deepnlp.org/store/ai-agent')
@@ -190,7 +172,7 @@ const uploadCommand = program.command('upload')
190
172
  uploadCommand.option('--github <url>', 'The GitHub repository URL for the open-sourced agent.');
191
173
  uploadCommand.option('--config <path>', 'Path to a .json or .yaml file containing the agent\'s meta information.');
192
174
  // Custom check for the required mutual exclusion
193
- uploadCommand.option('--endpoint <url>', 'The endpoint URL to post data to (overrides default).', REGISTRY_ENDPOINT);
175
+ uploadCommand.option('--endpoint <url>', 'The endpoint URL to post data to (overrides default).', "");
194
176
  uploadCommand.hook('preAction', (thisCommand) => {
195
177
  const options = thisCommand.opts();
196
178
  if (!options.github && !options.config) {
@@ -207,8 +189,8 @@ uploadCommand.hook('preAction', (thisCommand) => {
207
189
  // 2. SEARCH Command
208
190
  program.command('search')
209
191
  .description('Search for registered AI Agents by query or specific ID.')
210
- .option('-q <query>', 'A free-text query string to search for agents.')
211
- .option('--id <id>', 'The specific unique ID of the AI Agent to retrieve.', (value) => parseInt(value, 10))
192
+ .option('--q <query>', 'A free-text query string to search for agents.')
193
+ .option('--id <id>', 'The specific unique ID of the AI Agent to retrieve, e.g. "AI-Hub-Admin/my-first-ai-coding-agent" ')
212
194
  .option('--count-per-page <count>', 'Count per page of search results returned.', (value) => parseInt(value, 10), 10) // default=10
213
195
  .action(handleSearch);
214
196
  program.parse(process.argv);
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "name": "@aiagenta2z/agtm",
3
- "version": "1.0.1",
4
- "description": "Open Source CLI for AI Agent Marketplace Registration, AI Agents Management, AI Agents Index and Search",
3
+ "version": "1.0.2",
4
+ "description": "agtm: Open Source CLI for AI Agent Marketplace Registration, AI Agents Management, AI Agents Index and Search",
5
5
  "main": "dist/agtm-cli.js",
6
+ "type": "module",
6
7
  "bin": {
7
8
  "agtm": "dist/agtm-cli.js"
8
9
  },