Know when your Page is tagged or reviewed

from clickruntime import on_trigger, credentials, http, state, notify, report_fetched

G = "https://graph.facebook.com/v21.0"
PAGE_ID = "104857600000000"

def page_token():
    user = credentials.connection("facebook", "work")
    return http.get(f"{G}/{PAGE_ID}", params={"fields": "access_token", "access_token": user}).json()["access_token"]

@on_trigger
def run(event):
    token = page_token()
    seen = set(state.get("seen") or [])
    tagged = http.get(f"{G}/{PAGE_ID}/tagged", params={"fields": "id,message,permalink_url", "access_token": token}).json()["data"]
    ratings = http.get(f"{G}/{PAGE_ID}/ratings", params={"fields": "open_graph_story,review_text,recommendation_type,created_time",
                                                         "access_token": token}).json()["data"]
    items = [("Tagged", t["id"], t.get("message", ""), t["permalink_url"]) for t in tagged] + \
            [(f"Review ({r['recommendation_type']})", r["open_graph_story"]["id"], r.get("review_text", ""),
              f"https://www.facebook.com/{r['open_graph_story']['id']}") for r in ratings]
    new = [i for i in items if i[1] not in seen]
    report_fetched(len(new))
    if not new:
        return {"summary": "Nothing new"}
    notify.email_me(f"{len(new)} new Facebook mention(s)", "\n\n".join(f"{k}: {text}\n{url}" for k, _, text, url in new))
    state.set("seen", list(seen | {i[1] for i in new})[-1000:])
    return {"new": len(new)}