@qjp88995/provider-client 0.2.0 → 0.4.0

package/src/justone/errors.ts

@@ -0,0 +1,97 @@
+/**
+ * 失败的大类，调用方按它决定怎么跟人说、要不要重试：
+ * auth token 无效 / 权限不足 · balance 余额不足 · quota 配额用完 · rate-limit 速率超限 ·
+ * bad-request 服务端判参数错 · upstream 采集失败 / 服务端错误 · network 连接失败（含中心连不上 JustOne）·
+ * timeout 超时 · invalid-response 响应不成形 · aborted 调用方中途取消（请求已发出，只出现在调用记录里）。
+ */
+export const JUSTONE_FAILURE_KINDS = [
+  'auth',
+  'balance',
+  'quota',
+  'rate-limit',
+  'bad-request',
+  'upstream',
+  'network',
+  'timeout',
+  'invalid-response',
+  'aborted',
+] as const;
+export type JustOneFailureKind = (typeof JUSTONE_FAILURE_KINDS)[number];
+
+/** `JustOneUpstreamError.kind`：`aborted` 时客户端原样抛出取消原因，不包成本错误。 */
+export type JustOneUpstreamFailureKind = Exclude<JustOneFailureKind, 'aborted'>;
+
+/** 请求还没发出去就被拦下：接口不存在、参数缺了 / 多了 / 取值不对。调用方的错，重试没用。 */
+export class JustOneParamsError extends Error {
+  override readonly name = 'JustOneParamsError';
+  constructor(
+    readonly endpoint: string,
+    readonly problems: readonly string[]
+  ) {
+    super(`JustOne ${endpoint}：${problems.join('；')}`);
+  }
+}
+
+/** JustOne 调用失败。**message 里绝不带请求 URL**——直连时 GET 的 token 就在 query 里。 */
+export class JustOneUpstreamError extends Error {
+  override readonly name = 'JustOneUpstreamError';
+
+  constructor(
+    readonly endpoint: string,
+    readonly kind: JustOneUpstreamFailureKind,
+    reason: string,
+    readonly detail: {
+      /** 业务码（信封里的 `code`）；没拿到信封就是 null。 */
+      code: number | null;
+      httpStatus: number | null;
+      requestId: string | null;
+      /** 这类失败值不值得再试一次。判据只在 `classifyCode` 与客户端的抛出处。 */
+      retryable: boolean;
+      /** 一共试了几次（含首次）。 */
+      attempts: number;
+    }
+  ) {
+    super(`JustOne ${endpoint} 失败（${kind}）：${reason}`);
+  }
+
+  get code(): number | null {
+    return this.detail.code;
+  }
+
+  get retryable(): boolean {
+    return this.detail.retryable;
+  }
+}
+
+/** 文档列出的业务码（每个接口页的「业务码说明」）。 */
+const KNOWN_CODES: Record<
+  number,
+  { kind: JustOneUpstreamFailureKind; text: string }
+> = {
+  100: { kind: 'auth', text: 'Token 无效或已失效' },
+  301: { kind: 'upstream', text: '采集失败，请重试' },
+  302: { kind: 'rate-limit', text: '超出速率限制' },
+  303: { kind: 'quota', text: '超出每日配额' },
+  400: { kind: 'bad-request', text: '参数错误' },
+  500: { kind: 'upstream', text: '内部服务器错误' },
+  600: { kind: 'auth', text: '权限不足' },
+  601: { kind: 'balance', text: '账户余额不足' },
+  602: { kind: 'quota', text: 'TOKEN 限额超限' },
+};
+
+/** 会再试一次的业务码：官方明说「请重试」的 301，和服务端的 500 / 503。 */
+const RETRYABLE_CODES = new Set([301, 500, 503]);
+
+/** 非 0 业务码 → 失败大类 + 一句中文原因 + 值不值得重试。 */
+export function classifyCode(
+  code: number,
+  message: string | null
+): { kind: JustOneUpstreamFailureKind; reason: string; retryable: boolean } {
+  const known = KNOWN_CODES[code];
+  const vendorSays = message ? `：${message}` : '';
+  return {
+    kind: known?.kind ?? 'upstream',
+    reason: `业务码 ${code}（${known?.text ?? '文档未列出'}）${vendorSays}`,
+    retryable: RETRYABLE_CODES.has(code),
+  };
+}

package/src/justone/index.ts

@@ -0,0 +1,34 @@
+export {
+  createJustOne,
+  type JustOne,
+  JUSTONE_BASE_URL,
+  JUSTONE_TIMEOUT_MS,
+  type JustOneAttemptRecord,
+  type JustOneCallOptions,
+  type JustOneConnection,
+  type JustOneEndpointKey,
+  justOneEndpointSpec,
+  type JustOneOptions,
+  type JustOneParams,
+  type JustOneResult,
+} from './client.js';
+export type {
+  JustOneEndpointSpec,
+  JustOneParamsOf,
+  JustOneParamSpec,
+} from './endpoint-spec.js';
+export { JUSTONE_ENDPOINTS } from './endpoints.generated.js';
+export {
+  classifyCode,
+  JUSTONE_FAILURE_KINDS,
+  type JustOneFailureKind,
+  JustOneParamsError,
+  JustOneUpstreamError,
+  type JustOneUpstreamFailureKind,
+} from './errors.js';
+export { type NormalizedParams, normalizeParams } from './params.js';
+export {
+  JUSTONE_PRICE_FEN,
+  JUSTONE_PRICING_EXPORTED_AT,
+} from './pricing.generated.js';
+export { justOnePriceFen } from './pricing.js';

package/src/justone/params.ts

@@ -0,0 +1,91 @@
+import type { JustOneEndpointSpec } from './endpoint-spec.js';
+
+export type NormalizedParams =
+  | { ok: true; values: Record<string, string> }
+  | { ok: false; problems: string[] };
+
+/**
+ * 入参 → 线上的字符串表单。按登记表逐个核对：多余的参数、缺必填、类型不对、
+ * 不在枚举里，一次性全部列出来（给模型用时它能一次改对）。
+ *
+ * 宽进：值是 `undefined` / `null` / 空串的当作没给；数字与布尔也接受字符串写法
+ * （`"20"`、`"true"`）——模型给的参数常是字符串，类型化的调用方本来就传对了。
+ */
+export function normalizeParams(
+  spec: JustOneEndpointSpec,
+  raw: Readonly<Record<string, unknown>>
+): NormalizedParams {
+  const problems: string[] = [];
+  const values: Record<string, string> = {};
+
+  for (const name of Object.keys(raw)) {
+    if (!(name in spec.params)) {
+      problems.push(
+        name === 'token'
+          ? 'token 由客户端统一放，不要放进参数'
+          : `没有参数 ${name}`
+      );
+    }
+  }
+
+  for (const [name, p] of Object.entries(spec.params)) {
+    const v = raw[name];
+    if (v === undefined || v === null || v === '') {
+      if (p.required) problems.push(`缺少必填参数 ${name}`);
+      continue;
+    }
+    const text = toWire(v, p.type);
+    if (text === null) {
+      problems.push(`参数 ${name} 应为 ${TYPE_LABEL[p.type]}，收到 ${show(v)}`);
+      continue;
+    }
+    if (p.enum && !p.enum.includes(text)) {
+      problems.push(
+        `参数 ${name} 只能取 ${p.enum.join(' / ')}，收到 ${show(v)}`
+      );
+      continue;
+    }
+    values[name] = text;
+  }
+
+  return problems.length ? { ok: false, problems } : { ok: true, values };
+}
+
+const TYPE_LABEL = {
+  string: '字符串',
+  integer: '整数',
+  number: '数字',
+  boolean: '布尔值',
+} as const;
+
+function toWire(
+  v: unknown,
+  type: JustOneEndpointSpec['params'][string]['type']
+): string | null {
+  switch (type) {
+    case 'string':
+      return typeof v === 'string'
+        ? v
+        : typeof v === 'number' && Number.isFinite(v)
+          ? String(v)
+          : null;
+    case 'integer': {
+      const n = typeof v === 'string' ? Number(v.trim()) : v;
+      return typeof n === 'number' && Number.isSafeInteger(n)
+        ? String(n)
+        : null;
+    }
+    case 'number': {
+      const n = typeof v === 'string' ? Number(v.trim()) : v;
+      return typeof n === 'number' && Number.isFinite(n) ? String(n) : null;
+    }
+    case 'boolean':
+      if (typeof v === 'boolean') return String(v);
+      return v === 'true' || v === 'false' ? v : null;
+  }
+}
+
+function show(v: unknown): string {
+  const s = JSON.stringify(v) ?? String(v);
+  return s.length > 60 ? `${s.slice(0, 60)}…` : s;
+}

package/src/justone/pricing.generated.ts

@@ -0,0 +1,308 @@
+// 生成物，别手改：node packages/client/scripts/generate-justone-pricing.mjs <控制台导出的定价 xlsx>
+// 来源：JustOne 控制台「定价」导出（2026/10/27 01:10:47 UTC+8），共 294 个接口有价。
+
+import type { JUSTONE_ENDPOINTS } from './endpoints.generated.js';
+
+/** 定价表的导出时间。价格可能已经变了，展示时带上它。 */
+export const JUSTONE_PRICING_EXPORTED_AT = '2026/10/27 01:10:47 UTC+8';
+
+/**
+ * 每次请求的单价，单位：分（人民币）。登记表里有、这里没有的接口是导出里没有
+ * （当前账号看不到价或没有权限），按「价格未知」处理，别当成免费。
+ */
+export const JUSTONE_PRICE_FEN = {
+  '1688/get-item-detail/v1': 10,
+  '1688/search-item-list/v1': 10,
+  'aliexpress/get-product-detail/v1': 10,
+  'aliexpress/search-products/v1': 10,
+  'amazon/get-best-sellers/v1': 10,
+  'amazon/get-category-products/v1': 10,
+  'amazon/get-product-detail/v1': 10,
+  'amazon/get-product-top-reviews/v1': 10,
+  'amazon/search-products/v1': 10,
+  'bilibili/get-user-detail/v2': 10,
+  'bilibili/get-user-relation-stat/v1': 10,
+  'bilibili/get-user-video-list/v2': 10,
+  'bilibili/get-video-caption/v2': 10,
+  'bilibili/get-video-comment/v2': 10,
+  'bilibili/get-video-danmu/v2': 10,
+  'bilibili/get-video-detail/v2': 10,
+  'bilibili/search-video/v2': 10,
+  'bilibili/share-url-transfer/v1': 10,
+  'douban/get-movie-comments/v1': 10,
+  'douban/get-movie-review-detail/v1': 10,
+  'douban/get-movie-reviews/v1': 10,
+  'douban/get-recent-hot-movie/v1': 10,
+  'douban/get-recent-hot-tv/v1': 10,
+  'douban/get-subject-detail/v1': 10,
+  'douyin-ec/get-item-comments/v1': 18,
+  'douyin-ec/get-item-detail/v2': 18,
+  'douyin-ec/get-item-sku-info/v1': 30,
+  'douyin-ec/get-item-sku-info/v2': 25,
+  'douyin-ec/get-shop-item-list/v1': 20,
+  'douyin-ec/search-item-list/v1': 25,
+  'douyin-xingtu/gw/api/aggregator/get_author_commerce_seed_base_info/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_commerce_spread_info/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_contract_base_info': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_homepage_videos/v1': 50,
+  'douyin-xingtu/gw/api/aggregator/get_author_live_statistics/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_live_watch_distribution/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_order_experience/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_side_base_info/v1': 15,
+  'douyin-xingtu/gw/api/aggregator/get_author_tags/v1': 15,
+  'douyin-xingtu/gw/api/author/get_author_base_info/v1': 15,
+  'douyin-xingtu/gw/api/author/get_author_marketing_info/v1': 15,
+  'douyin-xingtu/gw/api/author/get_author_platform_channel_info_v2/v1': 15,
+  'douyin-xingtu/gw/api/author/get_author_show_items_v2/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_cp_info/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_link_struct/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_rec_videos_v2/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_touch_distribution/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/author_video_distribution/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/check_author_display/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_convert_ability/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_daily_fans/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_fans_distribution/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_link_info/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1': 50,
+  'douyin-xingtu/gw/api/data_sp/item_report_detail/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/item_report_th_analysis/v1': 15,
+  'douyin-xingtu/gw/api/data_sp/item_report_trend/v1': 15,
+  'douyin-xingtu/gw/api/data/get_author_hot_comment_tokens/v1': 15,
+  'douyin-xingtu/gw/api/gauthor/author_get_business_card_info/v1': 15,
+  'douyin-xingtu/gw/api/gauthor/get_author_content_hot_keywords/v1': 15,
+  'douyin-xingtu/gw/api/gsearch/search_for_author_square/v1': 50,
+  'douyin/get-user-detail/v3': 10,
+  'douyin/get-user-video-list/v1': 10,
+  'douyin/get-user-video-list/v3': 10,
+  'douyin/get-video-comment/v1': 10,
+  'douyin/get-video-detail/v2': 10,
+  'douyin/get-video-sub-comment/v1': 10,
+  'douyin/hot-search/v1': 20,
+  'douyin/search-image/v1': 20,
+  'douyin/search-user/v2': 10,
+  'douyin/search-video/v4': 10,
+  'douyin/share-url-transfer/v1': 10,
+  'facebook/get-comment-replies/v1': 20,
+  'facebook/get-post-comments/v1': 20,
+  'facebook/get-profile-id/v1': 20,
+  'facebook/get-profile-posts/v1': 20,
+  'facebook/search-post/v1': 20,
+  'imdb/news-by-category-query/v1': 5,
+  'imdb/streaming-picks-query/v1': 5,
+  'imdb/title-awards-summary-query/v1': 5,
+  'imdb/title-base-query/v1': 5,
+  'imdb/title-box-office-summary/v1': 5,
+  'imdb/title-chart-rankings/v1': 5,
+  'imdb/title-contribution-questions/v1': 5,
+  'imdb/title-countries-of-origin/v1': 5,
+  'imdb/title-critics-review-summary-query/v1': 5,
+  'imdb/title-details-query/v1': 5,
+  'imdb/title-did-you-know-query/v1': 5,
+  'imdb/title-extended-details-query/v1': 5,
+  'imdb/title-more-like-this-query/v1': 5,
+  'imdb/title-plot-query/v1': 5,
+  'imdb/title-redux-overview-query/v1': 5,
+  'imdb/title-release-expectation-query/v1': 5,
+  'imdb/title-top-cast-and-crew/v1': 5,
+  'imdb/title-user-reviews-summary-query/v1': 5,
+  'instagram/general-search/v1': 10,
+  'instagram/get-comment-replies/v1': 10,
+  'instagram/get-post-comments/v1': 10,
+  'instagram/get-post-detail/v1': 10,
+  'instagram/get-user-detail/v1': 10,
+  'instagram/get-user-detail/v2': 10,
+  'instagram/get-user-posts/v1': 10,
+  'instagram/search-hashtag-posts/v1': 10,
+  'instagram/search-reels/v1': 10,
+  'jd/get-item-comments/v1': 20,
+  'jd/get-item-description-images/v1': 15,
+  'jd/get-item-detail/v1': 20,
+  'jd/get-item-detail/v3': 40,
+  'jd/get-item-detail/v4': 25,
+  'jd/get-item-price/v1': 15,
+  'jd/get-shop-item-list/v1': 20,
+  'jd/search-item-list/v1': 15,
+  'kuaishou/get-user-detail/v1': 10,
+  'kuaishou/get-user-video-list/v2': 10,
+  'kuaishou/get-video-comment/v1': 10,
+  'kuaishou/get-video-detail/v2': 10,
+  'kuaishou/search-user/v2': 10,
+  'kuaishou/search-video/v1': 10,
+  'kuaishou/search-video/v2': 10,
+  'kuaishou/share-url-transfer/v1': 10,
+  'linkedin/get-post-comments/v1': 20,
+  'linkedin/get-user-detail/v1': 20,
+  'linkedin/get-user-posts/v1': 20,
+  'qq-huxuan/cgi-bin/advertiser/finder_publisher/detail/v1': 30,
+  'qq-huxuan/cgi-bin/advertiser/finder_publisher/get_finder_video_show/v1': 50,
+  'qq-huxuan/cgi-bin/advertiser/finder_publisher/get_rank_finder_content/v1': 30,
+  'qq-huxuan/cgi-bin/advertiser/finder_publisher/search/v1': 50,
+  'qq-huxuan/cgi-bin/advertiser/mp_publisher/detail/v1': 30,
+  'qq-huxuan/cgi-bin/advertiser/mp_publisher/get_user_articles/v1': 50,
+  'qq-huxuan/cgi-bin/advertiser/mp_publisher/search/v1': 50,
+  'reddit/get-post-comments/v1': 10,
+  'reddit/get-post-detail/v1': 10,
+  'reddit/search/v1': 10,
+  'search/v1': 20,
+  'shopee/get-item-detail/v1': 20,
+  'shopee/get-item-detail/v2': 20,
+  'shopee/get-item-installments/v1': 20,
+  'shopee/get-item-review-models/v1': 20,
+  'shopee/get-item-review-tags/v1': 20,
+  'shopee/get-item-reviews/v1': 20,
+  'shopee/get-item-sku-matrix/v1': 20,
+  'shopee/get-item-sku-models/v1': 20,
+  'shopee/get-item-snapshot/v1': 20,
+  'shopee/get-search-facets/v1': 20,
+  'shopee/get-shop-base/v1': 20,
+  'shopee/get-shop-categories/v1': 20,
+  'shopee/get-shop-detail/v1': 20,
+  'shopee/get-shop-item-list/v1': 20,
+  'shopee/get-shop-reviews-rich/v1': 20,
+  'shopee/get-shop-reviews/v1': 20,
+  'shopee/get-shop-seo/v1': 20,
+  'shopee/search-item-list/v1': 20,
+  'taobao/get-item-comment/v3': 20,
+  'taobao/get-item-detail/v1': 25,
+  'taobao/get-item-detail/v3': 60,
+  'taobao/get-item-detail/v4': 55,
+  'taobao/get-item-detail/v5': 15,
+  'taobao/get-item-detail/v6': 25,
+  'taobao/get-item-detail/v8': 25,
+  'taobao/get-item-detail/v9': 25,
+  'taobao/get-shop-item-list/v1': 15,
+  'taobao/get-shop-item-list/v2': 20,
+  'taobao/get-shop-item-list/v3': 30,
+  'taobao/get-shop-item-list/v4': 25,
+  'taobao/get-social-feed/v1': 15,
+  'taobao/search-item-list/v1': 20,
+  'taobao/search-item-list/v2': 25,
+  'tiktok-shop/get-product-detail/v1': 10,
+  'tiktok-shop/search-products/v1': 10,
+  'tiktok/get-post-comment/v1': 10,
+  'tiktok/get-post-detail/v1': 10,
+  'tiktok/get-post-sub-comment/v1': 10,
+  'tiktok/get-user-detail/v1': 10,
+  'tiktok/get-user-post/v1': 10,
+  'tiktok/search-post/v1': 10,
+  'toutiao/get-article-detail/v1': 10,
+  'toutiao/get-user-detail/v1': 10,
+  'toutiao/get-user-id/v1': 10,
+  'toutiao/get-video-detail/v1': 10,
+  'toutiao/search/v2': 50,
+  'twitter/get-post-comments/v1': 10,
+  'twitter/get-post-detail/v1': 10,
+  'twitter/get-user-detail/v1': 10,
+  'twitter/get-user-posts/v1': 10,
+  'twitter/search/v1': 10,
+  'weibo/get-fans/v1': 10,
+  'weibo/get-followers/v1': 10,
+  'weibo/get-post-comments/v1': 10,
+  'weibo/get-user-detail/v3': 10,
+  'weibo/get-user-post/v1': 10,
+  'weibo/get-user-video-list/v1': 10,
+  'weibo/get-weibo-detail/v1': 10,
+  'weibo/hot-search/v1': 10,
+  'weibo/search-all/v2': 10,
+  'weibo/search-profile/v1': 10,
+  'weibo/tv-component/v1': 10,
+  'weixin-channels/convert-export-id/v1': 15,
+  'weixin-channels/get-account-videos/v1': 50,
+  'weixin-channels/get-bound-channel/v1': 100,
+  'weixin-channels/get-video-basic-info/v1': 30,
+  'weixin-channels/get-video-comment/v1': 15,
+  'weixin-channels/get-video-download-url/v1': 30,
+  'weixin-channels/get-video-metrics/v1': 15,
+  'weixin-channels/get-video-share-url/v1': 20,
+  'weixin-channels/get-video-sub-comment/v1': 15,
+  'weixin-channels/get-video-title/v1': 15,
+  'weixin-channels/search-account/v1': 150,
+  'weixin-channels/search-account/v2': 100,
+  'weixin-channels/search-account/v3': 50,
+  'weixin-channels/search-video/v1': 80,
+  'weixin-channels/search-video/v2': 150,
+  'weixin/convert-article-link/v1': 10,
+  'weixin/get-account-basic-info/v1': 100,
+  'weixin/get-account-history-articles/v1': 30,
+  'weixin/get-account-history-articles/v2': 40,
+  'weixin/get-account-original-count/v1': 150,
+  'weixin/get-account-principal-info/v1': 100,
+  'weixin/get-article-comment/v1': 20,
+  'weixin/get-article-detail/v1': 15,
+  'weixin/get-article-detail/v2': 15,
+  'weixin/get-article-detail/v3': 20,
+  'weixin/get-article-detail/v4': 15,
+  'weixin/get-article-detail/v5': 15,
+  'weixin/get-article-metrics/v1': 15,
+  'weixin/get-article-metrics/v2': 20,
+  'weixin/get-article-sub-comment/v1': 20,
+  'weixin/search-account/v1': 40,
+  'weixin/search-account/v2': 150,
+  'weixin/search-article/v1': 80,
+  'weixin/search-article/v2': 80,
+  'weixin/search-miniprogram/v1': 80,
+  'weixin/search-suggestions/v1': 80,
+  'weixin/search-wechat-index/v1': 80,
+  'xianyu/get-item-detail/v1': 20,
+  'xianyu/search-item-list/v1': 20,
+  'xiaohongshu-ec/search-products/v1': 20,
+  'xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1': 15,
+  'xiaohongshu-pgy/api/pgy/kol/data/core_data/v1': 15,
+  'xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1': 50,
+  'xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/data/userId/fans_profile/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV2/costEffective/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV2/kolContentTags/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV2/kolFeatureTags/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV3/dataSummary/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV3/fansSummary/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/dataV3/notesRate/v1': 15,
+  'xiaohongshu-pgy/api/solar/kol/get_similar_kol/v1': 15,
+  'xiaohongshu-pgy/api/solar/note/noteId/detail/v1': 15,
+  'xiaohongshu-pgy/get-kol-note-list/v1': 50,
+  'xiaohongshu/ask-dots': 50,
+  'xiaohongshu/get-creator-hot-inspiration-feed/v1': 15,
+  'xiaohongshu/get-note-comment/v2': 15,
+  'xiaohongshu/get-note-detail/v1': 15,
+  'xiaohongshu/get-note-detail/v6': 15,
+  'xiaohongshu/get-note-sub-comment/v2': 15,
+  'xiaohongshu/get-topic-note-list/v1': 15,
+  'xiaohongshu/get-user-faved-note-list/v1': 15,
+  'xiaohongshu/get-user-note-list/v4': 15,
+  'xiaohongshu/get-user/v3': 15,
+  'xiaohongshu/hot-search/v1': 15,
+  'xiaohongshu/search-note/v2': 15,
+  'xiaohongshu/search-note/v4': 20,
+  'xiaohongshu/search-recommend/v1': 15,
+  'xiaohongshu/search-user/v2': 15,
+  'xiaohongshu/share-url-transfer/v1': 15,
+  'youku/get-user-detail/v1': 10,
+  'youku/get-video-detail/v1': 10,
+  'youku/search-video/v1': 10,
+  'youtube/get-channel-shorts/v1': 10,
+  'youtube/get-channel-videos/v1': 10,
+  'youtube/get-video-captions/v1': 10,
+  'youtube/get-video-comment/v1': 10,
+  'youtube/get-video-detail/v1': 10,
+  'youtube/get-video-sub-comment/v1': 10,
+  'youtube/search/v1': 10,
+  'zhihu/get-answer-comments/v1': 10,
+  'zhihu/get-answer-list/v1': 10,
+  'zhihu/get-column-article-detail/v1': 10,
+  'zhihu/get-column-article-list/v1': 10,
+  'zhihu/get-comment-replies/v1': 10,
+  'zhihu/get-user-articles/v1': 10,
+  'zhihu/get-user-follow-collections/v1': 10,
+  'zhihu/get-user-follow-columns/v1': 10,
+  'zhihu/get-user-follow-topics/v1': 10,
+  'zhihu/get-user-followees/v1': 10,
+  'zhihu/get-user-followers/v1': 10,
+  'zhihu/get-user-included-articles/v1': 10,
+  'zhihu/get-user-info/v1': 10,
+  'zhihu/search/v1': 20,
+} as const satisfies Partial<Record<keyof typeof JUSTONE_ENDPOINTS, number>>;

package/src/justone/pricing.ts

@@ -0,0 +1,11 @@
+import { JUSTONE_PRICE_FEN } from './pricing.generated.js';
+
+/**
+ * 接口现行单价（分）；定价表里没有就是 null——「价格未知」，别当成免费。
+ * 键在运行期才知道（库里存的、调用方传的），所以收 `string`。
+ */
+export function justOnePriceFen(endpoint: string): number | null {
+  return Object.hasOwn(JUSTONE_PRICE_FEN, endpoint)
+    ? JUSTONE_PRICE_FEN[endpoint as keyof typeof JUSTONE_PRICE_FEN]
+    : null;
+}