in reply to: https://github.com/snarfed/bridgy/issues

[Silo Request] openlibrary

Tatiana Leonteva
yepstepz

Hi! I want to contribute to brid.gy and add an integration with OpenLibrary.

Would be great to get notifications about the books I read, and since Goodreads deprecated their API, the best option could be the OpenLibrary.

The easiest option is to start from the listening part. They do not have any oAuth options right now, but API is available for GET option: https://openlibrary.org/developers/api

So what I think:

Login

After you login into Brid.gy with your website (indie auth), check profile page from OpenLibrary (OL) that you added to the input. for instance, https://openlibrary.org/people/zpetspey is my OL account, and it has my site https://yepstepz.io, and I can add

html
    ...
    <a href="https://openlibrary.org/people/zpetspey" rel="me"></a>
    ...

to my site. It would be enough to show that I want to listen some updates.

Updates

There are a few pages that I would possibly crawl to get my updates from:

  • currently-reading
  • read
  • would like to read

Bridgy could crawl it from time to time to get updates.

I don't see any eTag on curl -I request, but probably once in a day is ok.

Another interesting feature request could be to fetch year's goal and stats. Would be nice to get that updates from webmention.

Post

After crawling and getting updates, bridgy could form a post. There is a discussion about some properties here: https://github.com/microformats/h-entry/issues/10, so I need to research it further.

What do you think? I also have plans for investigating posting possibility, but wanted to check if this idea is ok with you.

Пост: github.com

Комментарии: 6

  • Ryan Barrett
    https://github.com/snarfed

    Interesting, thanks for filing!

    The vision and ideas here are pretty broad and wide-ranging. Could you give a specific example of an OpenLibrary post that you syndicated/cross-posted from an original post on your site, and the response(s) to it on OpenLibrary that you'd hope to backfeed to that original post as webmentions? And what existing microformats2 you'd expect those backfed responses to use? (We generally prefer to use existing, established microformats2 instead of new ones that aren't u…

  • Tatyana Leontieva
    https://github.com/yepstepz

    The vision and ideas here are pretty broad and wide-ranging. Could you give a specific example of an OpenLibrary post that you syndicated/cross-posted from an original post on your site, and the response(s) to it on OpenLibrary that you'd hope to backfeed to that original post as webmentions?

    Not on my web site, but I have this example https://gregorlove.com/2023/05/reading-funny-in-farsi/. As far as I know, you can't officially use goodreads API, so it's probably posted manually. So the idea …

  • Ryan Barrett
    https://github.com/snarfed

    Thanks! That helps a bit.

    It sounds like you're mostly interested in POSSEing your own reviews, ratings, "want to read," etc posts to OL? Except I don't see a write API for posting those things on https://openlibrary.org/developers/api . So you're thinking you'd post those in OL, on an existing book, and then Bridgy would send them back to your site via webmention? How would Bridgy find the corresponding "currently reading" post on your site? Would it look for a u-read-of pointing to the book on…

  • Ryan Barrett
    https://github.com/snarfed

    Oh, and try out more of these features in OpenLibrary itself too! It looks like you only joined a week ago, https://openlibrary.org/people/zpetspey , and you've posted one "already read" book, but no reviews or ratings or progress updates or anything else?

  • Tatyana Leontieva
    https://github.com/yepstepz

    Yeah, will try, sounds like a plan!

    It looks like you only joined a week ago

    yeah I tried to figure out how to build my book routine outside goodreads and thought it would be great to have mentions. I will give it a try surely, and hopefully will get back to this topic after some time :)

    Thank you for guidance :)

  • gRegor Morrill
    https://github.com/gRegorLove

    Hi @yepstepz!

    Not on my web site, but I have this example https://gregorlove.com/2023/05/reading-funny-in-farsi/. As far as I know, you can't officially use goodreads API, so it's probably posted manually.

    I make posts like that using Micropub requests, from https://indiebookclub.biz. It's a pretty basic tool: you enter title, author, and ISBN. You select one of the statuses: to-read, reading, and finished. If your site supports Micropub, it tries to publish the post to your site.

    Sparkles is …