Update to Perigon

Changed files

Choose a file to see its text changes. Binary or large files show metadata only.

plugin.json →

skills/perigon-news-research/SKILL.md →

skills/perigon-news-research/references/prompting.md →

plugin.json

− removed · + added

--- before
+++ after
@@ -1,8 +1,8 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "perigon",
-  "version": "0.1.7",
-  "description": "Search filterable news data, create monitors that extract structured events, and analyze coverage trends.",
+  "version": "0.1.8",
+  "description": "Search news and social posts, create news monitors that extract structured events, and analyze coverage trends.",
   "author": {
     "name": "Perigon"
   },
@@ -10,17 +10,17 @@
     "com.openai": {
       "interface": {
         "displayName": "Perigon",
-        "shortDescription": "News research and monitoring",
-        "longDescription": "Perigon helps analysts and researchers search, filter and analyze global news data. Search articles and stories by sentiment, journalist, publisher location, company, topic, language and date. Combine filters to find precise coverage, compare trends and produce briefings with source citations.\n\nCreate monitors that track matching news and extract structured fields for analysis. Example requests:\n\u2022 Create a monitor for AI startups raising a Series A. Extract funding value, industry, funding type and status.\n\u2022 Create a monitor for mentions of my brand in Perigon news coverage, with a sentiment breakdown.\n\u2022 Create a monitor for cybersecurity incidents in the financial sector. Extract severity, incident type, data exposure and affected companies.\n\nExplore monitor events and newsletters, then analyze results with Signal Insights exports and charts. New monitors default to drafts unless you ask to activate them. Brand monitoring requires your brand name and any relevant aliases; coverage depends on available sources and your filters.\n\nConnect your Perigon account through OAuth. Available tools and data depend on your organization permissions.",
+        "shortDescription": "News and social research",
+        "longDescription": "Perigon helps analysts and researchers search, filter and analyze news and social data. Search news articles and stories by sentiment, journalist, publisher location, company, topic, language and date. Combine filters to find precise coverage, compare trends and produce briefings with source citations.\n\nSearch public posts on X, Reddit and LinkedIn. Explore community discussions, professional commentary and company announcements using each platform\u2019s supported search filters. Retrieve LinkedIn person activity or company posts from a known profile or page URL. Results include available source links, authors, dates and engagement counts. Social results are samples of available coverage, not a measure of overall public opinion.\n\nCreate news monitors that track matching coverage and extract structured fields, such as funding amount, industry and funding type for AI startups raising a Series A, or severity, incident type, data exposure and affected companies for cybersecurity incidents. Explore monitor events and newsletters, then analyze results with Signal Insights exports and charts. New monitors default to drafts unless you ask to activate them. Social search does not create social monitors or publish posts.\n\nConnect your Perigon account through OAuth. Available tools and data depend on your organization permissions, including access to each social source.",
         "websiteURL": "https://perigon.io/docs/api/mcp",
         "logo": "./assets/icon.png",
         "composerIcon": "./assets/icon.png",
         "brandColor": "#227C9D",
         "brandColorDark": "#34B3E2",
         "defaultPrompt": [
-          "Find negative-sentiment coverage of electric vehicles from the past week and cite the sources.",
-          "Find journalists covering renewable energy, then show recent articles by two of them.",
-          "Find semiconductor news from publishers based in Germany, in English, from the past month."
+          "Find negative-sentiment news coverage of electric vehicles from the past week and cite the sources.",
+          "Compare recent news about AI agents with public discussion on X and Reddit. Cite sources and separate findings.",
+          "Find LinkedIn posts about AI funding from the past week, newest first, with source links and engagement counts."
         ],
         "developerName": "Perigon",
         "supportURL": "https://perigon.io/contact",
@@ -33,7 +33,9 @@
           "Research journalists and publishers",
           "Create news monitors",
           "Extract structured events",
-          "Export data and create charts"
+          "Export data and create charts",
+          "Search X and Reddit posts",
+          "Research LinkedIn posts and activity"
         ]
       },
       "review": {
@@ -52,10 +54,10 @@
               "expected_behavior": "Resolve Apple Inc. by profile/domain before filtering news by its returned company ID; use an explicit seven-day date window. Cite only returned articles. Do not confuse the company with the fruit or another entity; explain missing scope if unavailable."
             },
             {
-              "description": "Matched volume and sentiment time series. Valid single-day boundary using a fixed historical interval; retention must include October 2026.",
-              "prompt": "Compare daily article volume and sentiment for renewable energy on October 1, 2026, in UTC.",
+              "description": "Matched news volume and sentiment time series. Use the last seven complete UTC days within account retention.",
+              "prompt": "Compare daily news article volume and sentiment for renewable energy over the last seven complete UTC days.",
               "tools_triggered": "get_api_access, get_article_counts, get_avg_sentiment",
-              "expected_behavior": "Call both stats tools with identical q=renewable energy, from=2026-10-01T00:00:00Z, to=2026-10-01T23:59:59Z and splitBy=DAY. Report nonnegative counts and sentiment values exactly from returned buckets. Explicitly report no data if empty; do not count paginated articles as volume."
+              "expected_behavior": "Call get_article_counts and get_avg_sentiment with identical q=renewable energy, explicit from/to boundaries covering the last seven complete UTC days, and splitBy=DAY. Report actual counts and sentiment buckets; distinguish missing data from zero. Do not treat news statistics as social statistics."
             },
             {
               "description": "Cluster history workflow. Test account requires CLUSTERS access; select an actual returned cluster.",
@@ -68,12 +70,42 @@
               "prompt": "List my active monitors and tell me what the first one tracks. Do not change anything.",
               "tools_triggered": "get_api_access, list_monitors, get_monitor",
               "expected_behavior": "Filter active monitors, inspect the first returned UUID, and describe its actual configuration, type and status. If none exist, report that explicitly. Do not call set_monitor_status, create_monitor or update_monitor."
+            },
+            {
+              "description": "X search and ranking. Reviewer organization requires X access. Live results vary; explain missing access without fabricating results.",
+              "prompt": "Find recent English-language X posts about renewable energy from the past seven days and include engagement counts.",
+              "tools_triggered": "get_api_access, search_x_posts",
+              "expected_behavior": "Check social access; use query with renewable energy, lang:en and explicit since:/until: dates, searchType=LATEST. Cite returned URLs and only available metrics. Do not invent results or claim exhaustive coverage."
+            },
+            {
+              "description": "Reddit community filter and valid time/ranking combination. Requires REDDIT access. Live results vary; explain missing access without fabricating results.",
+              "prompt": "Show top posts about AI in r/technology from the past week, with scores and comment counts.",
+              "tools_triggered": "get_api_access, search_reddit_posts",
+              "expected_behavior": "Use query=AI, subreddit=technology, sort=TOP and time=WEEK. Summarize only returned posts and cite available URLs. Do not pass X operators or interpret score as a sentiment rating."
+            },
+            {
+              "description": "LinkedIn keyword search and date window. Requires LINKEDIN access. Live results vary; explain missing access without fabricating results.",
+              "prompt": "Find LinkedIn posts about AI funding from the past week, newest first.",
+              "tools_triggered": "get_api_access, search_linkedin_posts",
+              "expected_behavior": "Use query=AI AND funding, datePosted=PAST_WEEK and sortBy=DATE_POSTED. Do not add authorTitle unless requested. Cite returned posts. If pagination is needed use returned nextPage with unchanged filters."
+            },
+            {
+              "description": "LinkedIn company feed with an explicit reviewer-supplied URL. Requires LINKEDIN access. Live results vary; explain missing access without fabricating results.",
+              "prompt": "Show recent company posts from https://www.linkedin.com/company/google and summarize their announcements.",
+              "tools_triggered": "get_api_access, get_linkedin_company_posts",
+              "expected_behavior": "Use the supplied URL and type=ALL. Cite returned posts, distinguish announcements from independently verified facts, and do not invent dates or URLs. Preserve URL and type if following a returned cursor."
+            },
+            {
+              "description": "LinkedIn person activity with an explicit reviewer-supplied URL. Requires LINKEDIN access. Live results vary; explain missing access without fabricating results.",
+              "prompt": "Show recent posts and reposts from https://www.linkedin.com/in/williamhgates.",
+              "tools_triggered": "get_api_access, get_linkedin_person_activity",
+              "expected_behavior": "Use the supplied URL and type=POSTS. Distinguish original posts from reposts using returned data. Cite available URLs and report empty or inaccessible results honestly. Do not infer private activity."
             }
           ],
           "negative": [
             {
-              "description": "Unsupported publishing action. Explain Perigon cannot publish or distribute press releases. Do not invoke any Perigon tool or claim publication.",
-              "prompt": "Publish this press release to news outlets for me: We launched a new solar panel."
+              "description": "Unsupported social publishing. Explain that Perigon can read available social data but cannot publish, like, comment, or repost. Do not invoke a write tool or claim success.",
+              "prompt": "Publish this to my X and LinkedIn accounts: We launched a new solar panel."
             },
             {
               "description": "Unsupported account billing action. Explain billing-plan changes are outside these tools and direct the user to their account/support. Do not invoke Perigon tools or claim a purchase.",
@@ -87,10 +119,16 @@
         },
         "commerce": false,
         "commerce_description": "Paid access is not required. The underlying Perigon API has tiered access. This plugin does not provide purchasing or billing tools.",
-        "demo_recording_url": "https://drive.google.com/file/d/117VJgDOHewFJDOcATQ2XODvEWSTTmyWi/view?usp=sharing"
+        "demo_recording_url": "https://drive.google.com/file/d/117VJgDOHewFJDOcATQ2XODvEWSTTmyWi/view?usp=sharing",
+        "prompts": [
+          "Find negative-sentiment news coverage of electric vehicles from the past week and cite the sources.",
+          "Compare recent news about AI agents with public discussion on X and Reddit. Cite sources and separate findings.",
+          "Find LinkedIn posts about AI funding from the past week, newest first, with source links and engagement counts.",
+          "Show top posts about AI in r/technology from the past week."
+        ]
       },
       "publication": {
-        "release_notes": "Updated the monitor skill to interpret schedule hours and minutes as local wall-clock times in timezoneId, matching the Perigon product delivery settings, rather than treating them as UTC.",
+        "release_notes": "Adds listing, research-skill guidance and review cases for X, Reddit and LinkedIn search, LinkedIn person activity and company posts. Explains social-source permissions, platform-specific filters, pagination and evidence limits. News monitoring remains supported; social tools are read-only.",
         "countries": []
       },
       "apps": "./.app.json"