Goldfinger, a WebFinger client for Ruby

Gem Version Build Status

A WebFinger client for Ruby. Supports application/xrd+xml and application/jrd+json responses. Raises Goldfinger::NotFoundError on failure to fetch the Webfinger or XRD data, can also raise HTTP:Error or OpenSSL::SSL::SSLError if something is wrong with the HTTPS connection it uses.

  • Does not fall back to HTTP if HTTPS is not available
  • Does check host-meta XRD, but only if the standard WebFinger path yielded no result


gem install goldfinger


data = Goldfinger.finger('acct:[email protected]')'').href
# => ""

# => ["", ""]

# => "acct:[email protected]"

RFC support

The official WebFinger RFC is 7033.