@unavatar/core 3.43.0 → 3.45.0

package/README.md

@@ -19,21 +19,26 @@
 - [Providers](#providers)
   - [Apple Music](#apple-music)
   - [Apple Store](#apple-store)
+  - [Baidu Tieba](#baidu-tieba)
   - [Behance](#behance)
+  - [Bilibili](#bilibili)
   - [Bluesky](#bluesky)
   - [Buy Me a Coffee](#buy-me-a-coffee)
   - [CodePen](#codepen)
   - [Cults3D](#cults3d)
   - [Cursor](#cursor)
+  - [Deezer](#deezer)
   - [DeviantArt](#deviantart)
   - [Discord](#discord)
   - [Docker Hub](#docker-hub)
   - [Domain](#domain)
+  - [Douban](#douban)
   - [Dribbble](#dribbble)
   - [DuckDuckGo](#duckduckgo)
   - [Email](#email)
   - [Facebook](#facebook)
   - [Flickr](#flickr)
+  - [Gitee](#gitee)
   - [GitHub](#github)
   - [GitLab](#gitlab)
   - [Google](#google)
@@ -42,11 +47,13 @@
   - [Hevy](#hevy)
   - [Hugging Face](#hugging-face)
   - [Instagram](#instagram)
+  - [Juejin](#juejin)
   - [Ko-fi](#ko-fi)
   - [LinkedIn](#linkedin)
   - [Mastodon](#mastodon)
   - [Medium](#medium)
   - [Microlink](#microlink)
+  - [NetEase Music](#netease-music)
   - [npm](#npm)
   - [OnlyFans](#onlyfans)
   - [OpenStreetMap](#openstreetmap)
@@ -56,6 +63,7 @@
   - [Printables](#printables)
   - [Product Hunt](#product-hunt)
   - [PSN Profiles](#psn-profiles)
+  - [QQ](#qq)
   - [Raycast](#raycast)
   - [Reddit](#reddit)
   - [Snapchat](#snapchat)
@@ -73,10 +81,12 @@
   - [Tumblr](#tumblr)
   - [Twitch](#twitch)
   - [Vimeo](#vimeo)
+  - [Weibo](#weibo)
   - [WhatsApp](#whatsapp)
   - [X/Twitter](#xtwitter)
   - [Xbox Gamertag](#xbox-gamertag)
   - [YouTube](#youtube)
+  - [Zhihu](#zhihu)
 - [Response Format](#response-format)
 - [Response Headers](#response-headers)
 - [Response Errors](#response-errors)
@@ -557,12 +567,24 @@ Available inputs:
 - `id` (default): [unavatar.io/apple-store/id:529479190](https://unavatar.io/apple-store/id:529479190) or [unavatar.io/apple-store/id:6474323148@es](https://unavatar.io/apple-store/id:6474323148@es)
 - `name`: [unavatar.io/apple-store/name:pokemon%20go](https://unavatar.io/apple-store/name:pokemon%20go)
 
+### Baidu Tieba
+
+Get any Baidu Tieba user's profile picture by their username.
+
+e.g., [unavatar.io/tieba/Mojang](https://unavatar.io/tieba/Mojang)
+
 ### Behance
 
 Get any Behance user's profile picture by their username.
 
 e.g., [unavatar.io/behance/vitormatosinhos](https://unavatar.io/behance/vitormatosinhos)
 
+### Bilibili
+
+Get any Bilibili user's profile picture by their numeric uid.
+
+e.g., [unavatar.io/bilibili/2](https://unavatar.io/bilibili/2)
+
 ### Bluesky
 
 Get any Bluesky user's profile picture by their handle. Domain-style handles are supported.
@@ -596,6 +618,21 @@ Get any Cursor user's profile picture by their username.
 
 e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
 
+### Deezer
+
+Get artwork for any Deezer entity — artists, albums, playlists, or tracks. Look up by Deezer ID.
+
+By default the input is treated as an artist:
+
+e.g., [unavatar.io/deezer/27](https://unavatar.io/deezer/27)
+
+The input also supports a URI format `type:id`:
+
+- `artist` (default): [unavatar.io/deezer/artist:27](https://unavatar.io/deezer/artist:27)
+- `album`: [unavatar.io/deezer/album:302127](https://unavatar.io/deezer/album:302127)
+- `playlist`: [unavatar.io/deezer/playlist:908622995](https://unavatar.io/deezer/playlist:908622995)
+- `track`: [unavatar.io/deezer/track:3135556](https://unavatar.io/deezer/track:3135556)
+
 ### DeviantArt
 
 Get any DeviantArt user's profile picture by their username.
@@ -623,6 +660,12 @@ Retrieve logos and favicons from any hostname with a single URL. Domain-shaped p
 
 e.g., [unavatar.io/domain/microlink.io](https://unavatar.io/domain/microlink.io)
 
+### Douban
+
+Get any Douban user's profile picture by their username or numeric ID.
+
+e.g., [unavatar.io/douban/ahbei](https://unavatar.io/douban/ahbei)
+
 ### Dribbble
 
 Get any Dribbble designer's profile picture by their username.
@@ -679,6 +722,12 @@ Available inputs:
 - `user` (default): [unavatar.io/flickr/user:elizabethgadd](https://unavatar.io/flickr/user:elizabethgadd)
 - `group`: [unavatar.io/flickr/group:allthingsearthy](https://unavatar.io/flickr/group:allthingsearthy)
 
+### Gitee
+
+Get any Gitee user or organization's profile picture by their username.
+
+e.g., [unavatar.io/gitee/y_project](https://unavatar.io/gitee/y_project)
+
 ### GitHub
 
 Get any GitHub user or organization's profile picture by username, or resolve an avatar from a public email via GitHub search when the address matches a profile or commit history.
@@ -752,6 +801,12 @@ Get any Instagram user's profile picture by their username. No authentication or
 
 e.g., [unavatar.io/instagram/willsmith](https://unavatar.io/instagram/willsmith)
 
+### Juejin
+
+Get any Juejin user's profile picture by their numeric user ID.
+
+e.g., [unavatar.io/juejin/1556564194374926](https://unavatar.io/juejin/1556564194374926)
+
 ### Ko-fi
 
 Get any Ko-fi page's profile picture by the creator username.
@@ -787,6 +842,12 @@ Extract the logo or representative image from any URL. The page is rendered and
 
 e.g., [unavatar.io/microlink/microlink.io](https://unavatar.io/microlink/microlink.io)
 
+### NetEase Music
+
+Get any NetEase Cloud Music user's profile picture by their numeric user ID.
+
+e.g., [unavatar.io/netease-music/32953014](https://unavatar.io/netease-music/32953014)
+
 ### npm
 
 Get any npm user's profile picture by their username, including scoped handles.
@@ -851,6 +912,14 @@ Get any PlayStation Network user's profile picture by their PSN username.
 
 e.g., [unavatar.io/psnprofiles/Duff85](https://unavatar.io/psnprofiles/Duff85)
 
+### QQ
+
+Get any QQ user's profile picture by their QQ number.
+
+e.g., [unavatar.io/qq/10001](https://unavatar.io/qq/10001)
+
+Note: unknown numbers resolve to QQ's default avatar, similar to Gravatar.
+
 ### Raycast
 
 Get any Raycast user's profile picture by their username.
@@ -986,6 +1055,12 @@ Get any Vimeo user's profile picture by their username.
 
 e.g., [unavatar.io/vimeo/ladieswithlenses](https://unavatar.io/vimeo/ladieswithlenses)
 
+### Weibo
+
+Get any Weibo user's profile picture by their numeric uid or nickname.
+
+e.g., [unavatar.io/weibo/2803301701](https://unavatar.io/weibo/2803301701)
+
 ### WhatsApp
 
 Get the profile picture for a WhatsApp channel or chat by ID.
@@ -1025,6 +1100,12 @@ Available inputs:
 - `username`: [unavatar.io/youtube/casey](https://unavatar.io/youtube/casey)
 - `channel`: [unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw](https://unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw)
 
+### Zhihu
+
+Get any Zhihu user's profile picture by their URL token (the handle in the profile URL).
+
+e.g., [unavatar.io/zhihu/kaifulee](https://unavatar.io/zhihu/kaifulee)
+
 ## Response Format
 
 A response is returning the user avatar by default.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unavatar/core",
   "description": "Get unified user avatar from social networks, including Instagram, SoundCloud, Telegram, Twitter, YouTube & more.",
   "homepage": "https://unavatar.io",
-  "version": "3.43.0",
+  "version": "3.45.0",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",

package/src/providers/bilibili.js

@@ -0,0 +1,27 @@
+'use strict'
+
+const API_URL = 'https://api.bilibili.com/x/web-interface/card'
+
+const getAvatarUrl = input => `${API_URL}?mid=${encodeURIComponent(input)}`
+
+// Users without a custom avatar get the generic `noface.jpg` placeholder.
+const getAvatar = body => {
+  if (body?.code !== 0) return
+  const face = body.data?.card?.face
+  return face && !face.endsWith('/noface.jpg') ? face : undefined
+}
+
+module.exports = ({ got }) =>
+  async function bilibili (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/deezer.js

@@ -0,0 +1,32 @@
+'use strict'
+
+// Entities without artwork keep an empty image hash
+// (cdn-images.dzcdn.net/images/artist//500x500.jpg), which resolves to a
+// generic placeholder, so any empty hash segment is treated as a miss.
+const isArtwork = url => !/\/images\/[^/]+\/\/\d/.test(url)
+
+const getAvatarUrl = input => {
+  const [first, second] = input.split(':')
+  const type = second ? first : 'artist'
+  const id = second ?? first
+  return `https://www.deezer.com/en/${type}/${id}`
+}
+
+// Deezer server-renders og:image for missing entities as well, so the empty
+// placeholder is filtered out and everything else is returned as-is.
+const getAvatar = ({ $, getOgImage, NOT_FOUND }) => {
+  const image = getOgImage($)
+  return image && isArtwork(image) ? image : NOT_FOUND
+}
+
+const factory = ({ createHtmlProvider, getOgImage, NOT_FOUND }) =>
+  createHtmlProvider({
+    name: 'deezer',
+    url: getAvatarUrl,
+    getter: $ => getAvatar({ $, getOgImage, NOT_FOUND })
+  })
+
+factory.getAvatarUrl = getAvatarUrl
+factory.getAvatar = getAvatar
+
+module.exports = factory

package/src/providers/douban.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const getAvatarUrl = input => `https://www.douban.com/people/${input}/`
+
+const getAvatar = $ => $('img.userface').attr('src')
+
+module.exports = ({ createHtmlProvider }) =>
+  createHtmlProvider({
+    name: 'douban',
+    url: getAvatarUrl,
+    getter: getAvatar
+  })
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/gitee.js

@@ -0,0 +1,22 @@
+'use strict'
+
+const API_URL = 'https://gitee.com/api/v5/users'
+
+const getAvatarUrl = input => `${API_URL}/${encodeURIComponent(input)}`
+
+const getAvatar = body => body?.avatar_url || undefined
+
+module.exports = ({ got }) =>
+  async function gitee (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/index.js

@@ -6,28 +6,34 @@ const providersBy = {
     'apple-music',
     'apple-store',
     'behance',
+    'bilibili',
     'bluesky',
     'buymeacoffee',
     'cashapp',
     'codepen',
     'cults3d',
     'cursor',
+    'deezer',
     'deviantart',
     'discord',
     'dockerhub',
+    'douban',
     'dribbble',
     'facebook',
     'flickr',
+    'gitee',
     'github',
     'gitlab',
     'google-play',
     'huggingface',
     'hevy',
     'instagram',
+    'juejin',
     'ko-fi',
     'linkedin',
     'mastodon',
     'medium',
+    'netease-music',
     'npm',
     'onlyfans',
     'openstreetmap',
@@ -52,15 +58,18 @@ const providersBy = {
     'thingiverse',
     'threads',
     'tidal',
+    'tieba',
     'tiktok',
     'tumblr',
     'twitch',
     'venmo',
     'vimeo',
+    'weibo',
     'wise',
     'x',
     'xboxgamertag',
-    'youtube'
+    'youtube',
+    'zhihu'
   ],
   domain: ['microlink']
 }
@@ -70,19 +79,23 @@ module.exports = ctx => {
     'apple-music': require('./apple-music')(ctx),
     'apple-store': require('./apple-store')(ctx),
     behance: require('./behance')(ctx),
+    bilibili: require('./bilibili')(ctx),
     bluesky: require('./bluesky')(ctx),
     buymeacoffee: require('./buymeacoffee')(ctx),
     cashapp: require('./cashapp')(ctx),
     codepen: require('./codepen')(ctx),
     cults3d: require('./cults3d')(ctx),
     cursor: require('./cursor')(ctx),
+    deezer: require('./deezer')(ctx),
     deviantart: require('./deviantart')(ctx),
     discord: require('./discord')(ctx),
     dockerhub: require('./dockerhub')(ctx),
+    douban: require('./douban')(ctx),
     dribbble: require('./dribbble')(ctx),
     duckduckgo: require('./duckduckgo')(ctx),
     facebook: require('./facebook')(ctx),
     flickr: require('./flickr')(ctx),
+    gitee: require('./gitee')(ctx),
     github: require('./github')(ctx),
     gitlab: require('./gitlab')(ctx),
     google: require('./google')(ctx),
@@ -91,11 +104,13 @@ module.exports = ctx => {
     huggingface: require('./huggingface')(ctx),
     hevy: require('./hevy')(ctx),
     instagram: require('./instagram')(ctx),
+    juejin: require('./juejin')(ctx),
     'ko-fi': require('./ko-fi')(ctx),
     linkedin: require('./linkedin')(ctx),
     mastodon: require('./mastodon')(ctx),
     medium: require('./medium')(ctx),
     microlink: require('./microlink')(ctx),
+    'netease-music': require('./netease-music')(ctx),
     npm: require('./npm')(ctx),
     onlyfans: require('./onlyfans')(ctx),
     openstreetmap: require('./openstreetmap')(ctx),
@@ -106,6 +121,7 @@ module.exports = ctx => {
     primal: require('./primal')(ctx),
     producthunt: require('./producthunt')(ctx),
     psnprofiles: require('./psnprofiles')(ctx),
+    qq: require('./qq')(ctx),
     raycast: require('./raycast')(ctx),
     reddit: require('./reddit')(ctx),
     revolut: require('./revolut')(ctx),
@@ -120,16 +136,19 @@ module.exports = ctx => {
     thingiverse: require('./thingiverse')(ctx),
     threads: require('./threads')(ctx),
     tidal: require('./tidal')(ctx),
+    tieba: require('./tieba')(ctx),
     tiktok: require('./tiktok')(ctx),
     tumblr: require('./tumblr')(ctx),
     twitch: require('./twitch')(ctx),
     venmo: require('./venmo')(ctx),
     vimeo: require('./vimeo')(ctx),
+    weibo: require('./weibo')(ctx),
     whatsapp: require('./whatsapp')(ctx),
     wise: require('./wise')(ctx),
     x: require('./x')(ctx),
     xboxgamertag: require('./xboxgamertag')(ctx),
-    youtube: require('./youtube')(ctx)
+    youtube: require('./youtube')(ctx),
+    zhihu: require('./zhihu')(ctx)
   }
 
   return { providers, providersBy }

package/src/providers/juejin.js

@@ -0,0 +1,26 @@
+'use strict'
+
+const API_URL = 'https://api.juejin.cn/user_api/v1/user/get'
+
+const getAvatarUrl = input => `${API_URL}?user_id=${encodeURIComponent(input)}`
+
+// Unknown ids still respond `err_no: 0`, but with an empty profile.
+const getAvatar = body => {
+  if (body?.err_no !== 0) return
+  return body.data?.avatar_large || undefined
+}
+
+module.exports = ({ got }) =>
+  async function juejin (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/netease-music.js

@@ -0,0 +1,26 @@
+'use strict'
+
+const API_URL = 'https://music.163.com/api/v1/user/detail'
+
+const getAvatarUrl = input => `${API_URL}/${encodeURIComponent(input)}`
+
+// The API returns avatar URLs over plain HTTP; the CDN supports HTTPS.
+const getAvatar = body => {
+  const avatarUrl = body?.profile?.avatarUrl
+  return avatarUrl ? avatarUrl.replace(/^http:/, 'https:') : undefined
+}
+
+module.exports = ({ got }) =>
+  async function neteaseMusic (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/qq.js

@@ -0,0 +1,13 @@
+'use strict'
+
+// qlogo.cn serves a default placeholder for unknown numbers (gravatar-like),
+// so the URL always resolves and misses can't be detected upfront.
+const getAvatarUrl = input =>
+  `https://q1.qlogo.cn/g?b=qq&nk=${encodeURIComponent(input)}&s=640`
+
+module.exports = () =>
+  function qq (input) {
+    return getAvatarUrl(input)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl

package/src/providers/tieba.js

@@ -0,0 +1,36 @@
+'use strict'
+
+const PORTRAIT_URL = 'https://himg.bdimg.com/sys/portrait/item'
+
+const getAvatarUrl = input =>
+  `https://tieba.baidu.com/i/sys/user_json?un=${encodeURIComponent(
+    input
+  )}&ie=utf-8`
+
+const getAvatar = body => {
+  const portrait = body?.creator?.portrait
+  return portrait ? `${PORTRAIT_URL}/${portrait}` : undefined
+}
+
+module.exports = ({ got }) =>
+  async function tieba (input) {
+    // Unknown users respond with an empty body, which is not valid JSON.
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'text',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400 || !body) return
+
+    let json
+    try {
+      json = JSON.parse(body)
+    } catch {
+      return undefined
+    }
+
+    return getAvatar(json)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/weibo.js

@@ -0,0 +1,36 @@
+'use strict'
+
+const getAvatarUrl = input =>
+  /^\d+$/.test(input)
+    ? `https://m.weibo.cn/u/${input}`
+    : `https://m.weibo.cn/n/${encodeURIComponent(input)}`
+
+// The profile avatar is served as a signed, expiring crop
+// (`/crop.0.0.W.H.180/file?ssig=…`); rewriting it to `/large/file` yields a
+// stable, unsigned, full-resolution URL. Default avatars live under
+// `/default/`, which is treated as a miss.
+const getAvatar = ({ $, NOT_FOUND }) => {
+  const src = $('.m-avatar-box img').attr('src')
+  if (!src) return
+
+  const url = new URL(src, 'https://m.weibo.cn')
+  if (url.pathname.includes('/default/')) return NOT_FOUND
+
+  const filename = url.pathname.slice(url.pathname.lastIndexOf('/'))
+  return `${url.origin}/large${filename}`
+}
+
+// The page sits behind Weibo's visitor gate (a JS cookie-setting redirect)
+// and the avatar is injected after hydration, so it must be prerendered.
+module.exports = ({ createHtmlProvider, NOT_FOUND }) =>
+  createHtmlProvider({
+    name: 'weibo',
+    url: getAvatarUrl,
+    getter: $ => getAvatar({ $, NOT_FOUND }),
+    htmlOpts: () => ({
+      prerender: true
+    })
+  })
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/zhihu.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const API_URL = 'https://www.zhihu.com/api/v4/members'
+
+const getAvatarUrl = input =>
+  `${API_URL}/${encodeURIComponent(input)}?include=avatar_url`
+
+// Misses (and bot challenges) come back as an `error` payload rather than
+// a plain 404, and default avatars are flagged via `use_default_avatar`.
+const getAvatar = body => {
+  if (!body || body.error || body.use_default_avatar) return
+  return body.avatar_url || undefined
+}
+
+module.exports = ({ got }) =>
+  async function zhihu (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar