Adapter: YCLIENTS

オープン
#1,411 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
70/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
json, typescript
領域
api

調査の方向性

Start with the six steps in AGENTS.md under 'Add an adapter' and the walkthrough in #982, then run npm run adapter:new -- yclients --region intl --auth BEARER_TOKEN to scaffold the files. Read docs/tool-definition.md for the tool and response-mapping format, and check the YCLIENTS developer docs for the exact Authorization header. Done means node scripts/validate-adapters.mjs --warn passes without new warnings, the catalog is regenerated, the spec intl/yclients.live.spec.ts has static assertions, and the logo is added.

索引モデルが issue の本文から書いたものです。

説明

adapter-request good first issue help wanted

👋 A self-contained first contribution: one JSON adapter file, a spec and a logo. No need to know the rest of the codebase.

Why this one

In the last 30 days, 2 different workspaces on AnythingMCP Cloud searched the catalog for YCLIENTS and found nothing. People want it; nobody has built it yet.

The API

  • Docs: https://developers.yclients.com/
  • Auth: a partner token plus a user token in the Authorization header (Bearer <partner>, User <user>); check the docs for the exact format
  • Category: Booking

Suggested first tools (read-only)

list companies, list appointments (records) by date, list services, list staff. Read-only tools are enough for a first version; write tools can follow in a later PR.

How

Follow the six steps in AGENTS.md → Add an adapter and docs/tool-definition.md. The scaffold command for this one:

npm run adapter:new -- yclients --region intl --auth BEARER_TOKEN

Then node scripts/validate-adapters.mjs --warn, node scripts/regenerate-catalog.mjs, a intl/yclients.live.spec.ts (static assertions always, live calls behind RUN_YCLIENTS_LIVE=1), node scripts/adapter-count.mjs --check and the logo. The walkthrough and past examples are in #982.

Done when

  • The adapter validates without new warnings and the catalog is regenerated.
  • Every tool has a description an AI can act on (what it returns, when to use it) and a response mapping that keeps the useful fields.
  • The PR says which calls you ran against a real account, or that you could not and built it from the docs.

Claim it

Comment here to claim it. A claim without a PR for 14 days goes back to the pool, no hard feelings. Sign the CLA when the bot asks.

主要言語
TypeScript
スター
856
フォーク
82
平均マージ
6時間 43分
マージ済み PR(30日)
399

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

HelpCode-ai/anythingmcp のほかの issue

HelpCode-ai/anythingmcp の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。